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Introduction 


INTRODUCTION 


Many different versions of BASIC are commercially 
available from computer manufacturers. These 
different versions vary greatly in computational 
precision, programming power, ease of programming, 
speed of execution, and amount of memory required 
for the BASIC program. There are a number of 
BASICs available which are similar in capability to 
the original BASIC developed at Dartmouth College. 
These BASICs typically require about 8K of memory. 
There are also a number of tiny BASICS available 
that require only 2K of memory but which have 
different or less capability than an 8K BASIC. For 
many of today's demanding applications, more 
features are required than were provided in the 
original Dartmouth BASIC. A BASIC that provides 


advanced features and capabilities is frequently 


called an Extended BASIC. The features included in 
Extended BASICS also vary widely among computer 
manufacturers. 


Cromemco 16K Extended BASIC (which was developed 
exclusively for Cromemco by Shepardson 
Microsystems, Inc.) is designed to maximize 
computational precision, programming power, and 
speed of execution by fully utilizing the extensive 
158 instruction set of the Z-8% microprocessor. 


Cromemco's powerful Extended BASIC was specifically 
designed to meet the most demanding requirements of 
business firms (such as inventory and accounting 
programs) while providing the flexibility and speed 
necessary for real-time control applications in 
both industry and the home. A brief review of some 
of the features included in Cromemco 16K Extended 
BASIC follows. 


One major feature of Cromemco 16K Extended BASIC is 
rapid, 14-digit arithmetic using the powerful, 
binary-coded decimal (BCD) arithmetic instructions 
which are unique to the Z-8@ microprocessor. All 
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arithmetic operations are performed using the 16 
high-speed registers of the central processor for 
intermediate storage. The speed and precision 
obtained when performing BCD arithmetic cannot be 
obtained on 7-register microprocessors such as the 
88808. Many BASICS were designed for six or seven 
digit precision using computer-oriented binary 


arithmetic. It is possible to do calculations 
which are aS accurate using binary arithmetic as 
they are using BCD arithmetic. However,, many 


BASICs which use binary arithmetic have introduced 
highly visible errors when calculating dollar and 
cent conversions in business and financial 
programs. These conversion errors cannot occur in 
BASICs which utilize BCD arithmetic. In addition 
to arithmetic operations, all functions in Cromemco 
16K Extended BASIC are computed to 14-digit 
accuracy. Many other BASICs that provide 14-digit 
accuracy do so at greatly reduced execution speeds 
and often without carrying full accuracy through 
all subroutines. 


Real-time control applications often require 
integer, 16-bit (4 1/2 digit) arithmetic. Cromemco 
16K Extended BASIC provides this capability along 
with direct memory, input/output, and machine-code 
subroutine. access through BASIC instructions. 
There is also often a need in real-time control 
system applications to store large arrays of data. 
Cromemco 16K Extended BASIC offers the flexibility 
of allowing the user to manipulate, store, and 
retrieve six-digit floating point numbers. This 
abbreviated form of the highly efficient, 14-digit 
mathematics capability is also slightly faster in 
execution than the 14-digit format. 


Furthermore, in Cromemco 16K BASIC (unlike most 
microcomputer BASICs), constants used in program 
lines. cause execution speeds as fast or faster than 
variable references, In addition, integer 
constants occupy no more room than variable 
references. 


Execution speed is maximized in 16K Extended BASIC 
by the utilization of a semi-compiling design. The 
semi-compiling design provides many of the 
important features of both a compiler and an 
interpreter. In other words, the properties of a 
compiler which provide high execution speed are 
combined with the interactive capabilities and 
programming ease provided through an interpreter. 
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For example, programs may be stopped during 
execution, examined, and modified. The computer 
may then be instructed to continue to run the 
program without affecting the proper execution of 
the program. The ability to stop, examine, and 
modify programs can greatly reduce the time and 
cost associated with computer programming. This 
interactive capability is not available with 
optimized compilers. The semi-compiling operation 
of 16K Extended BASIC is performed after each 
program line is entered. Any syntax errors are 
detected at the time of entry rather than during 
execution. Consequently, the time required to 
enter and debug a program is reduced substantially. 


Some versions of BASIC have either rudimentary or 
no error message capability. With these versions, 
if a fatal error causes the program to crash or 
halt unexpectedly during execution, it is up to the 
user to reconstruct the failure within the program. 
Other versions will produce a numerical value after 

7 the program fails. This. value must be interpreted 

C from a list of error messages. Some more powerful 
BASIC programs will return an English-language 
statement explaining the failure after the fact. 
Cromemco 16K Extended BASIC not only generates 
English-language error messages, but it also 
examines each statement as it is entered and prints 
error messages immediately. The value of such pre- 
checking, using the error messages, can be 
pronounced. This capability is extremely important 
when making corrections to real-time control 
systems where inadvertent errors in modifications 
can be costly. In general programming, the 
interactive aspect of the error messages is 
extremely convenient and can substantially reduce 
programming time and errors. 


Dynamic error trapping is provided in Cromemco 16K 

Extended BASIC for specialized routing of program 

control in response to BASIC generated error 

conditions. Using the error trapping feature, 

overflow and underflow arithmetic errors can be 

handled without operator assistance. The value of 

this feature in preparing programs that will be 

used by unskilled operators cannot be 
underestimated. For instance, should a disk 

ee read/write error occur, 16K Extended BASIC can be 
q programmed to type out a message such as: CALL MR. 
: HIGGINS (415-@30-1234) IN THE ACCOUNTING DEPARTMENT 
thereby alerting skilled personnel who can correct 
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the problem. 


A TRACE feature is provided in Cromemco 16K BASIC 
to help determine the origin of errors which are 
difficult to find in a program being written. Line 
numbers are logged as they are executed with this 
feature. FOR loops are automatically indented as 
they are logged in the TRACE mode. 


Cromemco 16K Extended BASIC also has advanced 
floppy disk input/output capabilities. For 
example, both programs and data may be stored on a 
disk. Programs may be stored in internal machine 
(binary) or ASCII format. Numeric and ASCII string 
data may be stored on a disk using sequential or 


random access methods, The number of files which 


may be opened simultaneously is limited only by the 
amount of memory the user allocates for file 
purposes, and an unlimited number of files may be 
opened and closed during the course of a program. 
Chaining of program segments too large to fit in 
memory at one time can be performed with parameters 
passed through disk files or memory. File names 
can be string variables and can be changed 
dynamically (at runtime) by the BASIC program. 
BASIC programs can be written, modified, or run by 
other BASIC programs. Line numbers can be altered 


and two programs can be retrieved from the disk and 


concatenated into one program. The versatility 
provided through the interaction of the Cromemco 
Disk Operating System (CDOS) and the disk 
input/output capabilities of Cromemco 15K Extended 
BASIC is uncommon. 


Many BASICs have string handling capability. 
However, many of these limit the number of 
characters that can be stored in the string to a 
maximum of 255. In Cromemco 16K Extended BASIC, up 
to 32,767 characters or the available memory space 


are allowed -- whichever limit is smaller. 
Substrings are utilized to rapidly manipulate these 
strings. Again, the design of the language 


emphasizes speed, versatility, and accuracy. A 
special, high-speed, string-searching function is 
provided to increase throughput in string 
manipulation and sorting operations (such as are 
commonly found in mailing list processing 
programs). 


Program listings from 16K BASIC are print justified 
and are uniformly spaced for reading ease and 
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clarity of documentation. FOR loops are also 
automatically nested and: indented by the listing 
function. In the semi-compiling operation, the 
only statements that are directly stored in memory 
at entry time are the REM comment statements (and 
even here spaces are compressed). All other 
statements are semi-compiled and stored in machine 
readable format. When listed, this machine 
readable format is reconverted into ASCII format 
and then printed. Thus all spacing and other’ 
variations are lost in the conversion process, 
This conversion process allows Cromemco 16K BASIC 
to efficiently store large programs by storing 
Programs only once in semi-compiled format. In 
contrast, many other BASICS always maintain an 
uncompiled, one-to-one representation of what was 
typed in, along with any internal, execution 
related storage. Such BASICs require extra program 
Storage if blank spaces are typed inadvertently 
into the program text. Blank spaces can slow down 
Program execution. Cromemco 16K Extended BASIC 
does not store, nor is it affected by, 
inadvertently typed blank spaces. Furthermore, 
these extra blank spaces are not listed in the 
program output. 


There are a number of features commonly found ‘in 
most Extended BASICs that are included in Cromemco 
16K Extended BASIC. These features include multi- 
statement lines; one, two, and three dimensional 
arrays; 26 user-definable functions; advanced 
formatting capabilities with PRINT USING, TAB, 
SPACE, and SYS/SET functions; and direct machine 
language interaction with INP, OUT, PEEK, POKE, and 
USR instructions. Finally, Cromemco 16K Extended 
BASIC also has flexible INPUT and PRINT routines 


-which are capable of Supporting a wide range of 


terminals and line printers. 


This manual was designed for use both by users who 
have no prior experience with BASIC and by 
experienced programmers. Users with little or no 
prior experience are encouraged to read sections 
1.8 through 1.3 and then proceed to Chapter 7, 
Programming Examples. These examples are designed 
to introduce Cromemco 16K Extended BASIC to the 
novice programmer. Chapter 19 is a Glossary and 
may be consulted if the definition of a term is in 
question. 


Both the beginner and experienced programmer will 
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gain insight into BASIC's file structures and 
access methods by reading Chapter 15, Discussion of 
Data File I/O. 


The advanced user will want to refer to Chapters 
17, 18, and 21 (the Appendix) as well as to section 
1.4, A Technical Discussion. 


Computers and Computing Power 


A computer is a device which performs high-speed 
mathematical or logical calculations or which 
processes information derived from coded data in 
accordance with a predetermined program. This 
predetermined program is a set of instructions 
arranged in logical sequence which directs the 
computer to perform a desired operation. 


All computers are based on one fundamental concept 
-- the binary digit. The binary number system uses 
only the digits @ and 1. The binary digit concept 
is so useful because it can be represented by any 
device which is capable of assuming one of two 
possible stable states (on and off). A computer, 
even in its most complex form, is simply a 
collection of logic gates which respond to the 
presence or absence of a voltage. The presence or 
absence of such voltages, called logic levels, 
makes it possible to represent binary conditions in 
a logic circuit. Typically, these logic levels are 
defined as @'s for off states and 1's for on 
states. 


Binary digits, commonly called bits, can be used to 
represent numbers of any magnitude by grouping 
digits together. The primary level at which binary 
digits are grouped within a particular computer is 
called word size. Most microcomputers use an 8-bit 
word size. This 8-bit unit is called a byte. If 
we consider the various computer words we can make 
out of all possible combinations of eight bits, we 


find that there are 2 to the 8th power or 255 . 


possible combinations. We can then build a 
computer which will respond differently to each 
byte which we present as an instruction. For 
example, an instruction of all @®'s might mean stop, 
while 10191018 might mean increment a number by l. 
Furthermore, a particular byte might stand for one 
operation when used with one model of computer and 
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might stand for a very different operation in 
another computer system. The important point is 
that all computers execute instructions through 
this binary language which is a combination of on- 
off states represented by O's and 1's, 


As stated in the introduction, a computer must be 
programmed to perform calculations or to process 
information. Programs are prepared in a language 
with precise rules of grammar. Currently available 
computer languages fall into one of two major 
categories: high-level or low-level languages. 
Internally, computers perform various operations 
‘according to the binary language described earlier. 
This binary language is commonly called machine 
language. Machine language is at the lowest level 
of computer languages and consists of groups of on 
and off states. A machine language word is any 
combination of eight O's and 1's, (e.g., #1100100). 
AS you can see, it is nearly impossible to tell 
what a given machine language word means by simply 
looking at the binary word. Furthermore, 
programming a computer in this fashion would be 
both time-consuming and tedious. 


To simplify the programming process, some easier 
method of entering and recognizing instructions is 
required. The next step in low-level languages 
then, is an assembly language which uses. short 
mnemonic symbols that assist in the definition of 
the instruction. An assembly language translates 
simple instructions, such as HALT or INCREMENT, 
into the appropriate machine language instructions. 
But even this form of programming is too cumbersome 
for many applications. In assembly language, a 
Program to print out "HELLO" on a terminal may 
require as many as 5@ steps. Furthermore, 
individuals without a great deal of computer 
expertise often find it difficult to translate 
problems into a computer program at either the 
assembly or machine language level. 


As a result, higher level languages were developed 
with instructions and rules of grammar which are 
easier to learn and apply. Problem-oriented, high 
level languages include FORTRAN, COBOL, PASCAL, PL- 
-l, and a variety of other languages. These high- 
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level languages are translated into machine 
language through programs called compilers. Any 
language that must be compiled or translated one or 
more times before it is reduced to the machine code 
is said to be a high-level language. 


Basic and Its Uses 


Most of the high-level languages mentioned in the 
previous section were designed for use by special 
groups comprised of relatively sophisticated 
computer users. Consequently, most of these 
languages are somewhat difficult. to learn. 
However, aS the computer moved from the design- 
laboratory into the university laboratory and then 
on into business, home, and school usage, the need 
for an easy to learn, grammatically simple, English 
language based, programming language grew. To 
answer this need, Professors John G. Kemeny and 
Thomas E. Kurtz of Dartmouth College developed the 
first version of BASIC in 1965. BASIC is a higher 
level language which is easy to learn and which can 
be applied to most computing problems. 


In addition to being easy to learn, BASIC has a 
number of features which make it useful for two 
very important and common applications: time- 
sharing systems and interactive programming. In 
BASIC, simple, English language instructions are 
translated line by line as the program executes 
into machine code through a program called an 
interpreter. This interpreter makes it easy to 
interrupt the conversion process, proceed to 
another task, and then return to pick up where you 
left off. Consequently, a computer can be used to 
allow multiple users running BASIC to timeshare a 
system. In timesharing, the computer handles each 
user in some specified sequence. The high speed of 
the computer, however, makes it appear that all 
users are being handled simultaneously. 


BASIC is also particularly well-adapted for use in 
interactive programs which require continual user 
interaction with the computer. Interactive 
programming allows the user to continually update 
and revise a program based on intermediate results. 
For complex problems involving a number of 
parameters that may require changing before a 
solution is reached, the interactive programming 


16 


ao, 
f 


CROMEMCO 16K EXTENDED BASIC INSTRUCTION MANUAL 


1. 


Introduction 


capability is a powerful tool. 


Because of these important features, the library of 
programs written in BASIC, many of them in the 
public domain, has expanded rapidly. Many complex 
business programs, including inventory control, 
payroll, shipping and receiving, and accounting, 
are available in BASIC. There are programs written 
for computer assisted instruction (CAI) and for a 
wide range of interactive games in which users 
compete with each other or with the computer in 
simulations of a variety of situations and events. 


In addition, the same computer system may be used 
to streamline accounting procedures, control 
manufacturing processes, regulate energy usage, or 
play games. Only the BASIC program need be 
changed. With the introduction of inexpensive, 
microcomputer-based, time-sharing systems (such as 
the multi-user version of the Cromemco System Three 
Computer), true multi-user computer operation 
becomes available at only a fraction of its cost 
five years ago. 


A Technical Discussion of the 


A sizable portion of the material in this section 
will be of interest to those who might be relative 
novices in the field of system-level programming. 
Also, it is hoped that more advanced programmers 
will appreciate the information presented relating 
to the internals of Cromemco 16K BASIC. 


The 16K Extended BASIC Language is an incremental 
compiler written in Z-8@ code by Shepardson 
Microsystems, Inc. of Cupertino, CA specifically 
for, and to the specifications,of, Cromemco, Inc. 


An incremental compiler is a type of interpreter 
which not only fully checks for correct syntax as 
the source is being entered, it also immediately 
resolves any references to undefined items. The 
primary advantage of the incremental compiler is 
execution speed. Since variable and line number 
references are already resolved, no execution time 
is spent searching tables for items such as a 
variable name match. 
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Syntax Related Tables 


As each statement line (or direct command 
instruction) is entered from the keyboard (or some 
other I/0 device), it is checked for correct 
language syntax and converted into an internal 
format. Actually, the routine which does the 
syntax checking also converts source items into 
internal tokens at the same time. The BASIC 
Ssyntaxer is actually driven by a set of syntax 
tables, the purposes of which are described below. 


The Reserved Name Table contains a list of all 
instruction, function, and operator names that are 
recognized by BASIC. This table is used to equate 
the user's ASCII input to a particular internal 
token. Thus in addition to the reserved name, each 
entry contains the token to be used. 


Main Syntax Table. Once the first reserved name in 
an instruction has been found, the instruction may 
be classified as to type. The type directs BASIC 
to an entry in the main syntax table, where an 
entry is made up of a list of required and/or 
optional further items (actually their equated 
tokens) that must be found in the statement. If a 
required item is not found in the proper position 
in the input line, a syntax error is generated. 
This table is quite complex, as even such things as 
arithmetic expressions in all thetr variations must 
be covered. There are even syntax subroutines 
included here, so that a statement type may require 
(for example) a subscripted string name by calling 
for a subroutine which in turn requires a string 
variable, a left parenthesis, subscripts, and a 
right parenthesis. (Please note that this is not 
actually how the search is performed; it is 
actually more segmented and more highly organized 
than stated here.) 


The syntax table contains other information about 
instruction types, such as whether they are allowed 
in direct mode (a command), within a program (a 
statement), or both places. It can also declare 
that an instruction must be the last one in a line 
or that subsequent instructions on the same line 
are permitted. 


The Binding Strength Table is more properly 
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described as a run-time table, since it determines 
the priority in which operators (+, -, AND, NOT, 
etc.) are to be executed. It is included here 
because it is used to relate the internal tokens 
for the various operators to their priorities. 


On Listing a Program 


After a program has been converted to internal 
token form, it is obviously desirable to be able to 
implement the LIST instruction. On unaltered 
source types of interpreter, this is simply a 
matter of dumping the memory contents back out to 
the list device. In Cromemco BASIC, the problem is 
significantly more complex. Fach token must be 
reconverted to its ASCII form and (as we shall see 
later) constants must be reconverted to external 
format. 


Tables in User Program Memory Space 


Generally, these types of tables are referred to as 
runtime tables, though many of them are established 
at program entry time. They are the fundamental 
tables which the interpereter uses in executing a 
user program. 


The Statement Table is not strictly speaking a 
table. It is simply an area of memory where all 
program lines are stored after they have been 
converted to internal format. The most 
distinguishing feature of this table in Cromemco 
BASIC is that the last line entered is always at 
the end of the table. Only when a line is deleted 
or modified is it necessary to slide the table (in 
order to recover the space occupied by the deleted 
parts). Also note that the program's line numbers 
are not stored in the statement table. Instead, 
the line numbers are found in the line number 
table. 


Line Number Table. This table is also known as the 
Label Table. Herein are stored the actual line 
numbers. Also in this table each entry has the 
address of the beginning of its corresponding 
program line within the statement table. The third 
item in each entry in this table is the address 
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within the table of the next logical succeeding 
line (i.e., the line next to be executed unless 
program flow is altered by a GOTO, GOSUB, or NEXT 
statement). Note the implication here: even this 
table is not organized in line number order! As 
each new line is entered, its label entry is simply 
appended to the table and the logical successor 
pointers are updated as needed. 


Variable Table. When a variable is first defined 
(which occurs as the first line using it is 
entered), an entry is created for it in this table. 
There are many types of information contained 
herein. All variables have their name ('Al', 'AS', 
'E') and variable type (string, integer, short or 
long floating point, and/or array) stored here. In 
addition, scalar variables (non-array numeric 
variables) have their actual value stored here. 
Strings have their dimension and current length 
stored also. Arrays have the number of dimensions 
in use noted as well as the maximum value of each 
dimension. In addition, arrays and string entries 
contain the address of the actual location of -the 
data for each. The data so addressed is located 
within the string/array table. 


String/Array Table. Again, this table is not so 
much a table as simply a section of memory reserved 
for the storage of array and string data. Of the 
tables mentioned so far, this one is unique in that 
it is allocated (expanded) at runtime. That is, 
since statements of the form: 


318 INPUT J 
328 DIM AS(J), B3(J,2) 


are legal, arrays and strings cannot have their 
space allocated to them until they are actually 
dimensioned during program execution. 


The For/Next Table. An entry is placed in this 
table whenever a FOR instruction is encountered. 
Information kept here includes the address of the 
corresponding variable table entry, the size of 
STEP requested (or implied), the terminating TO 
value, and the address of the entry in the label 
table corresponding to the line logically following 
the FOR instruction. If a FOR statement is 
executed using a variable with an entry already 
stored in the FOR/NEXT table, the old entry is 
deleted, the table is adjusted, and the new entry 
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is appended. 


User-Defined Functions Table. Since only user- 
defined functions FNA through FNZ are allowed in 
16K BASIC this is a fixed length table with 26 
entries, each active one of which contains the 
address of the label entry corresponding to the 
line where the function was defined. 


An Example 


There follows an actual example of what happens 
internally to BASIC when a program line is entered 
(syntax time) and then executed (run time). It is 
assumed that any existing program and/or data has 
been removed via a SCRatch command and that the 
example line shown is the first (and only, though 
this is not significant) line entered towards 
creating a new program. 


This is the example line: 


160 IF A2 = 3.7 THEN 360 


Syntax Time 


The first thing detected is the line number, '100'. 
This line number is placed in the label table along 
with the address of the beginning of the statement 
table (where the encoded line will be Stored). 
Since this is the only entry in the label table, 
the successor pointer will be set to zero to 
indicate no successor. Since the label table works 
from the top down, the pointer to the bottom of the 
table would be updated to indicate where to place 
the next entry. So far, then, the label table 
looks something like this: 


2 bytes -- pointer to statement in statement 
table 
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2 bytes -- pointer to successor label (zero, 
currently) 
3 bytes -- the line number, 109, in BCD (5 


digits significant) 


Next, the keyword 'IF' is encountered and 
recognized as a valid statement type. It is 
translated to a single byte internal token and the 
syntax table entry for '‘'IF' is accessed. The 
syntax for 'IF' requires that the keyword be 
followed by an expression, so the appropriate 
syntax subroutine is called. 


Without going into detail as to what a valid 
expression is, and how the syntaxer determines that 
it has or has not encountered one, it is sufficient 
to note that certainly 'A2=3.7' would be considered 
valid. That being so, the variable 'A2' makes its 
first appearance and must be added to the variable 
table. Its entry would look something like this: 


2 bytes -- the variable name (A2) 


l byte -- the variable type, assume a 62, 
short floating point 


4 bytes -- the actual value of the variable, 
in the length required for its 
type. This is set to zero until 
altered. 


The statement table would receive a byte signifying 
that a numeric variable had been found followed by 
two bytes which are the address of the entry for 
'A2' within the variable table. 


The equals sign ('=") would be recognized as an 
operator, and its internal code stored next in the 
statement table. 


The value '3.7' would be recognized as a floating- 
point constant (integer constants don't have 
decimal points), and a routine would be called to 
translate it to internal format. The statement 
table would receive a byte signifying a particular 
type of constant (short-floating here) followed, 
and then the internal constant would be stored. 


The ‘IF' syntax requires that the expression be 
followed by a 'THEN' keyword. When it is found, 
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its internal token is stored in the statement 
table. 


'THEN' may be followed by either another whole new 
instruction or (as in this case) by a line number. 
The processing of this line number is partly what 
qualifies the Cromemco BASIC interpreter to be 
called an incremental compiler. 


The label table is scanned for a line number '300'. 
When it is not found, an entry is made for it 
similar to the one previously made for line '199'. 
However, for line number 3800, the address of its 
corresponding line in the statement table is set to 
an illegal value to indicate that it doesn't exist. 
Later, if a line 39@ were entered, the address 
would be changed to reflect the fact. Also, the 
entry for line 198 is updated to reflect that its 
logical successor is line 388 (the next 
sequentially numbered line). 


The statement table receives a token to indicate 
that a label table address will follow, and then 
the address of the label table entry for line '399' 
is stored. Finally, a byte of zero (8%) is stored 
to indicate the end of line. 


At this point, then, the statement table will 
contain the following: 


1 byte -- token for 'IF' 

l byte -- token, a variable table address 
follows 

2 bytes -- the variable table address for 'A2' 

1 byte -- token for '=' 

l byte -- contains @2 hex to indicate that a 
short floating point constant 
follows 

4 bytes -- the internal form of the constant 
we ee fa 

l byte -- token for 'THEN' 

1 byte -- token, a label table address 
follows 
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2 bytes -- label table address for line number 
39GB 
l byte -- value @@ hex, indicates end of line 


1.4.4.2 Run Time 


Assume now that the user requested a RUN of the 
program (and, incidently, even this simple 
statement must go through the syntax process before 
it is executed.) 


BASIC searches out the first logical line of the 
program from the label table and then performs the 
following steps: 


First, the address of the statement within the 
statement table is found. Then the first byte of 
the statement is used to vector to the routine 
responsible for processing IF statements. 


The ‘'IF' processor knows that what follows is an 
expression, so it calls the expression execution 
routine to evaluate 'A2 = 3.7'. 


The expression evaluator notes that the first item 
is a variable, so it uses the variable address to 
extract the value of the variable from the variable 
table entry for 'A2'. It places this value in an 
area of memory referred to as the argument stack. 


The '=' relational operator (note: this is not the 
same thing as the assignment operator '=' used in 
LET instructions) is then pushed onto another 
BASIC-maintained stack known as the operator stack. 


The constant token causes the short floating point 
constant '3.7' to also be placed on the argument 
stack. 


Since there is no more to the expression, the 
expression evaluator calls on the processing 
routine for the equal relational operator. The 
equality processing routine extracts the two values 
(contents of 'A2' and the value '3.7') and returns 
either a one (1) if they are equal or a zero (@) if 
they are not. The expression evaluator is finished 
and returns with this value to the 'IF' processor. 
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At this point let us examine what happens if the 
value returned is ‘'1' (which it can't be in our 
example). The ‘'IF' processor ignores the 'THEN' 
token (it has to be there, the syntaxer passed it!) 
and encounters the label table token. This implies 
a change in program flow to the line specified in 
the table entry. So the 'IF' processor simply 
Places the entry encountered in BASIC's own ‘next 
logical statement' location. It then checks to 
ensure that a line really exists to correspond to 
the entry. The line does not exist and BASIC 
issues the error message, GOTO UNDEFINED LINE 
NUMBER. 


Now backtrack a bit and assume that the expression 
evaluator had returned with a '@' instead (which it 
would in our example). In this case, the 'IF' 
processor simply aborts processing of its line and 
returns to allow BASIC to execute the next logical 
line. When BASIC encounters the next logical line 
('390' in our example) it checks to see if the line 
exists (it doesn't here) and executes it if it 
does. If it does not, BASIC ignores the line and 
falls through to the next logical line. Since line 
388 does not exist, and since there is no logical 
successor, BASIC would print out ***END***, 


In Cromemco BASIC, there is no speed penalty for 
using any and as many variables wherever desired in 
the program, there is no reason to put certain 
statements (i.e., subroutines) first in the 
program, and constants in programs execute as fast 
or faster than variables. 


25 


CROMEMCO 16K EXTENDED BASIC INSTRUCTION MANUAL 


26 


poms 


fecunsdalatdtiss cast ai 


CROMEMCO 16K EXTENDED BASIC INSTRUCTION MANUAL 


2. 


aa 


2.1 


Instruction Syntax 


INSTRUCTION SYNTAX 


The Cromemco 16K BASIC language is designed to 
allow the user to structure and format a program in 
a wide variety of styles. This section covers the 
features which allow this flexibility as well as 
those elements of BASIC syntax which do affect 
program operation. 


Spaces or Blank Characters 


All spaces are optional within 16K BASIC except for 
those which are included as part of text (i.e., 
REMarks, string literals and string variables, see 
sections 4.3 and 5.2). Once a program has been 
entered in BASIC, the spacing within a listed 
program will automatically conform to BASIC 
standards. The following user interaction with 
BASIC demonstrates both that spaces are ignored on 
input, and that BASIC stores a program in a 
Standard format. 


>>1 @BPR INT"This is a string literal" 
>>12@REM The spacing within the string literal 
>>13@REM and the REMark statements will not be 
>>149REM changed by BASIC. 

>>15@FORI=1T0O19 

>>169MPRINT I ; 

>>179NE XT I 

>>1 80EN D 

>>L IST 


1698 PRINT"This is a string literal" 

120 REM The spacing within the string literal 
13@ REM and the REMark statements will not be 
148 REM changed by BASIC. 

158 FOR I=1 TO 19 

16@ PRINT I;. 

178 NEXT I 

18@ END 
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Upper Case Characters 


All letters used in Cromemco 16K BASIC must be 
upper case (capital). The only exceptions to this 
are string literals, string variables, and REMarks 
which may contain any printable characters. If any 
BASIC instruction is entered in lower case letters, 
a syntax error will result. 


The BASIC Prompt (>>) 


When BASIC is ready to accept a command or 
statement line, it displays a prompt which consists 
of two greater than symbols (>>). The purpose of 
the prompt is to indicate that BASIC has finished 
its last task and is waiting for the user's next 
instruction. 


Commands 


A command is a BASIC instruction which is executed 
immediately (as soon as the carriage return is 
depressed). Commands have no line numbers because 
they are not stored by BASIC. 


Cromemco 16K BASIC allows most instructions to be 
used as commands. For example, BASIC can be used 
as a calculator while it is in the command mode: 


>>PRINT 20000/5 
4088 


>>PRINT (4000+77)/63. 
64.714285714285 


As can be seen, a command may be given whenever the 
BASIC prompt (>>) is displayed. 


In this manual, the term instruction includes both 
commands and statements. All instructions listed 
as instructions or commands may be used as 
commands, while those listed as statements may not 
be used as commands. 


28 


tS, 


fo 
ra \ 


CROMEMCO 16K EXTENDED BASIC INSTRUCTION MANUAL 
2. Instruction Syntax 


26D ea. 


Statements 


A statement is a BASIC program line which contains 
one or more instructions, and which is stored for 
execution at a later time. Statements are not 
executed until the RUN command, or some other 
command which will begin execution of a program, is 
given. A statement line has a unique (within a 
program) line number by which it can be accessed. 
If a second statement is entered with the line 
number of a line which already exists, the original 
line will be replaced by the new line. 


Cromemco 16K BASIC allows most instructions to be 
used as statements. For example, one BASIC program 
can load and run another BASIC program: 


188 RUN "PROG2" 


Execution of this statement will cause PROG2 to be 
loaded into the User Area and execution to begin. 


In this manual, the term instruction includes both 
statements and commands. All instructions listed 
as instructions or statements may be used as 
Statements, while those listed as commands may not 
be used as statements. 


Multiple Instruction Lines 


Cromemco 16K BASIC allows more than one instruction 
to be associated with a single line number. Each 
pair of adjacent instructions must be separated by 
a colon (:). The number of instructions which may 
appear on a single line is limited only by the 
length of a line. For example: 


196 INPUT A : IF A<@ THEN GOTO 1899 
280 PRINT SOR(A) : PRINT : PRINT 
389 REM LINE 208 WILL SKIP 2 LINES 


User defined functions (DEF FNs) and DATA 
statements must appear as a single instruction on a 
line, The following instructions may appear as 
part of a multi-instruction line but they must be 
the last instruction on the line, i.e., no other 
instruction may follow on the same line. 
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RUN 

REM 

GOTO 

GOSUB 

RETURN 

FOR 

ON...GOTO (GOSUB) 
ENTER 

DELETE 


A colon may not terminate a multiple instruction 
line. A colon must be followed by another 
instruction. 


The IF...THEN instruction is unique when followed 
by other instructions on the same line. The reader 
is referred to the IF...THEN instruction for a 
further discussion. 
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NUMERIC AND STRING 


INTERNAL MACHINE REPRESENTATION 


Numeric and string alphanumeric information is 
Stored by BASIC in different forms. This section 
explains these different formats. 


Integer 


Integers are whole numbers and in 16K BASIC they 
must be within the range +32767 to -32768. When 
stored by BASIC, an integer occupies 2 bytes of 
memory. 


Integer numbers are stored low byte first, high 
byte second. If the high bit of the high byte is a 
1, then the number is negative; if it is a ®, then 
the number is positive. 


A positive number is stored as the binary 
representation of the number. 


A negative number is stored as the 2's complement 
of the number. 


Example: 


The number 1234 will be represented by the 
hexadecimal bytes D2 @4 when stored as an Integer. 
When the order of the bytes is reversed (G4 D2) 
this is the binary equivalent of the decimal number 
1234. 


The number -1234 will be represented by the 
hexadecimal bytes FB 2E when stored as an Integer. 
When the order of the bytes is reversed (2E FB) 
this is the 2's complement of the binary equivalent 
of the decimal number 1234. Because the high bit 
of the high byte was 1 (before the 2's complement 
was taken), the number is negative (-1234). 
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Short Floating Point 


A Short Floating Point number stored by BASIC 
occupies 4 bytes, has an accuracy of 6 digits, and 


must be within the range +9.99+62 to +9.99E-65. 


The first byte of a Short Floating Point number 
contains the sign of the number and the exponent in 
excess 40H (64 decimal) notation. If the high bit 
of the first byte is a 1, then the number is 
negative; if it is a @, then the number is 
positive. Note that this is not the sign of the 
exponent but rather of the number itself. The 
remaining 7 bits of the first byte contain the 
exponent plus 46H. In order to find the true 
exponent, 40H (64 decimal) must be subtracted from 
this number. 


The remaining three bytes contain the BCD (Binary 
Coded Decimal) mantissa which has been normalized 
to a value between @ and 1. The implicit decimal 
point is located before the first byte of the 
mantissa. Each byte of the mantissa can contain 2 
significant digits yielding a total of 6 
significant digits for a Short Floating Point 
number. 


Example: 


The number -1.2345E+21 will be represented by the 
hexadecimal bytes D6 12 34 5@ when stored as a 
Short Floating Point number. 


The first bit of the first byte is a 1 indicating 
that the number is negative. The remaining 7 bits 
of the first byte (56H or 86 decimal) is the 
exponent plus 4@H. To get the true exponent 49H 
must be subtracted from 56H. This leaves an 
exponent of 16H or 22 decimal. This is not the 
exponent of the original number because the number 
was normalized. In this example, normalization 
involved dividing the number by 18 and adding 1 to 
the exponent to compensate for the division. 


The remaining three bytes are the BCD 
representation of the normalized number. BCD 
stands for Binary Coded Decimal which is a method 
of representing a decimal number in binary. Using 
this method, each byte can contain two one digit 
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decimal numbers. As can be seen from the example, 
non-significant digits are zero filled. 


Long Floating Point 


A Long Floating Point number stored by BASIC 
occupies 8 bytes, has an accuracy of 14 digits, and 
must be within the range +9.99+62 to +9.99E-65. 


The internal representation of a Long Floating 
Point number is similar to that of a Short Floating 
Point number. The difference is that four 
additional bytes are added to the mantissa for a 
total of 7 bytes. This is how a Long Floating 
Point number can maintain 14 significant digits. 


Hexadecimal 


A Hexadecimal number occupies two bytes and must be 
within the range @H to FFFFH. 


The internal representation of a hexadecimal number 
is the same as that of an Integer. Except for the 
functions BINAND, BINOR, and BINXOR, hexadecimal 
numbers are treated as signed integers (refer to 
section 3.1). 


String 


A string is an ordered list of alphanumeric 
information. Examples of strings include words, 
sentences, parts of words, groups of letters or 
special characters. 


Elements of a string (characters) stored by BASIC 
occupy 1 byte each. They are represented 
internally as an eight bit number which is the 
ASCII (American Standard Code for Information 
Interchange) code for the character being stored. 
Bit number 7 (the high bit) is a parity bit and, 
although it effects string comparisons, it does not 
effect the character which is PRINTed. 
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CONSTANT AND STRING LITERAL FORMATS 


Constants are, as the name implies, unchanging. 
They each have one value. 


String literals are similar to constants in that 
they each maintain one value which does not change. 


This section covers the standard formats for 
constants and string literals in 16K BASIC. 


A constant is a number. It does not change value 
and is represented as it would be in any arithmetic 
computation. 


There are three types of constants: integer, 
floating point, and hexadecimal. All constants 
(not specified as hexadecimal) equal to or greater 
than 198,888 and those containing a decimal point 
are always stored by BASIC as floating point 
numbers (either Short or Long Floating Point 
depending on the current mode, but always Long if 
there are more than 6 significant :digits). All 
constants (not specified as hexadecimal) with a 
value less than 19,0988 and not containing a decimal 
point are stored by BASIC as Integer numbers. 


Constants 
Floating Point Integer 
20088 55 
3. 9985 
- 888376 5 
12.7 , 458 
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Floating point constants (1.2, 3., 1E6, etc.) are 
stored according to the mode which is active when 
they are entered. An exception is a constant with 
more than 6 significant digits, which is always 
stored as a Long Floating Point number. For 
example, if the active mode is set to Short 
Floating Point (see the SF MODE instruction) and 
the following commands are given: 


>>LONG L 
Pol = lef 3s 


L will be assigned a value of 9%.333333000000008 
because 1. and 3. are SHORT (SFMODE was current 
when they were entered). But, under the same 
circumstances, if we had said: 


>>LONG L 
>>L = 1./3.80800000 


L would have been assigned a value of 
6 .33333333333333 because 3.00800090009 is forced to 
LONG (more than 6 significant digits). 


If in the two previous examples, the current mode 
had been Long Floating Point, L would have received 
a value of 9.33333333333333 in both cases because 
both 1. and 3. would have been stored as Long 
Floating Point numbers. 


Hexadecimal Constants 


Hexadecimal numbers are used in base 16 arithmetic. 
The set of digits used in hexadecimal arithmetic is 
@ through 9 and A through F. 


In Cromemco 16K BASIC, hexadecimal constants are 


identified by leading and trailing percent (3%) 
signs. 


36 


CROMEMCO 16K EXTENDED BASIC INSTRUCTION MANUAL 
4. Constant and String Literal Formats 


Constants 


Equivalent 


Hexadecimal Decimal 
S8BWSIS -32768 
ZI9DOOS -28672 
SFFEFFZ -l 

BOB 9 

ZAZ 1¢ 

SFR 15 
Z1BS 16 
SBS 128 
SFP 255 

Zl VHS 256 
37FFEFS 32767 


A hexadecimal number is stored in the same format 


aS an integer and may be used wherever a constant 
is allowed. 


String Literals 


A string literal is a string which is enclosed 
between quotation marks. The quotation marks are 
not part of the string itself, but are used to 
delimit (mark the ends of) the String. The value 
of a string literal does not change. 


A quotation mark can be represented within a String 
literal by the use of two quotation marks, one 
immediately following the other. 


String Literals 
"This is a string literal" 
“Here are imbedded ""quotation"" marks" 
"{special} *+- characters are ok." 
" 
just spaces" 
The trailing quotation mark on a string literal is 
not required at the end of a line. In this case, 


the carriage RETURN will terminate, but not be a 
part of, the string literal. 


37 


CROMEMCO 16K EXTENDED BASIC INSTRUCTION MANUAL 


38 


ite 
£ é 


CROMEMCO 16K EXTENDED BASIC INSTRUCTION MANUAL 
5. Variable Representation 


VARIABLE REPRESENTATION 


Variables are, as the name implies, able to change 
or vary in value. As a program is executed, 
variables may be assigned new values at any time. 
This section covers the standard formats for 
variables in 16K BASIC. 


Numeric Variables 


Numeric variables may be assigned numeric values. 
The range and accuracy of these variables depends 
on their type. See Chapter 3 on Numeric Internal 
Machine Representation for more information. 


Format of Numeric Variables 


Numeric variables are represented by a single 
letter (A-Z) or a single letter followed by a 
Single number (9-9). There are 286 possible 


- numeric variable names (A, A@, Al, A2,...,A9, B, 


BO, Bl gaweeph Oy Cy COy Cl eas ep gp 205 2h ieee glen: 20) 
In compliance with the rules of 16K BASIC, only 
upper case letters may be used in variable names. 


Integer Variables 


Specific variables may be set to Integer by the 
INTEGER instruction. The default mode for 
variables may be set to Integer if the IMODE 
instruction is given before the RUN instruction. 
Refer to the sections covering Integer Internal 
Machine Representation, and the INTEGER and IMODE 
instructions, 
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5.1.4 


Short Floating Point Variables 


Specific variables may be set to Short Floating 
Point by the SHORT instruction. The default mode 
for variables may be set to Short Floating Point if 
the SFMODE instruction is given before the RUN 
instruction. Refer to the sections covering Short 
Floating Point Internal Machine Representation, and 
the SHORT and SFMODE instructions. 


Long Floating Point Variables 


Specific variables may be set to Long Floating 
Point by the LONG instruction. Long Floating Point 
mode is normally the default mode. If the mode has 
been changed to SFMODE or IMODE, the default mode 
for variables may be reset to Long Floating Point 
if the LFMODE instruction is given before the RUN 
instruction. Refer to the sections covering Long 
Floating Point Internal Machine Representation, and 
the LONG and LFMODE instructions. 


Matrices and Lists 


A matrix is an array of numeric variables in a 
prescribed form. For example, the array: 


3 2 @ 
1 4 6 
-3 4 #5 


is a matrix with three rows and three columns. A 
matrix with m rows and n columns is written: 


all al2 al3 ...aln 


a2l1 a22 a23 ...a2n 


aml am2 am3 ...amn 
The individual entries in the matrix are called 
elements or cells. For example the quantity aij in 
the above matrix is the element in row i and column 
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Sele Dyed 


ji. Subscripts used to indicate elements always 
denote the row first and the column second. 
Cromemco BASIC permits the user to define one, two, 
or three dimensional matrices. A two (i.e., Mij) 
or three (i.e., Mijk) dimensional matrix is 
commonly called a table. A one dimensional matrix, 
a matrix with n columns but only one row, is 
commonly called a list. For example, the matrix: 


3, ~l, 5, -8 


is a list (or a matrix) with one row and four 
columns. 


A matrix may be defined to be composed of Long or 
Short Floating Point or Integer variables. 


Format 


A matrix is named in the same manner as a numeric 
variable. A specific element of a matrix is 
accessed by the matrix name followed by 1, 2, or 3 
indices enclosed in parentheses. These indices may 
be numeric expressions, variables, or constants. 


Singly dimensioned matricies are implicitly 
dimensioned as 10. Larger singly dimensioned as 
well as 2 and 3 dimensional matrices must be 
explicitly dimensioned by the DIMension, INTEGER, 
LONG, or SHORT instruction. 


An element of a matrix may be used anywhere a 
variable is allowed. 


String Variables 


String variables may be assigned alphanumeric 
values. This includes all letters (both upper and 
lower case), numbers, and all printable and non- 
printable characters. Refer to the section on 
String Internal Machine Representation for more 
information. : 
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Format 


String variables are represented by a single letter 
(A-Z) followed by a dollar sign ($) or a single 
letter followed by a single number (0-9) followed 
by a dollar sign. In compliance with the rules of 
16K BASIC, only upper case letters may be used in 
string variable names. Some examples of string 
variable names are: 


Dimensioning String Variables 


There is, for most purposes, no limit to the size 
(i.e., number of characters) of a string literal 
that may be assigned to a string variable, 
However, the default value in 16K BASIC for string 
size is 11 or fewer characters. If string values 
of more than 11 characters are to be assigned to a 
variable, the string variable must be DIMensioned. 
The DIM statement is used in BASIC to define the 
size of a string variable (see the description of 
DIM in Chapter 11). 


Example: 


1@ DIM Al1$(28), BS(3@), C4S (4B) 


In this example, the string variable A1S$ is 
dimensioned to allow for strings up to 21 
characters in length, the variable BS is 
dimensioned to allow up to 31 characters, and C4S$ 
is dimensioned for up to 41 characters. Any string 
value assigned to a variable which exceeds the 
specified dimension is truncated. Consequently, 
the programmer should be sure to dimension string 
variables to handle the largest string which will 
be input. 


Note: DIM A$(28) allows a 21 character string 
because string bytes are numbered from @ through 
the specified DIM size. Remember that using the 
@th element of strings (and arrays) can save memory 
space, 
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5.2.3.1 


A string of length zero is called a NULL string. 


Referencing String Variables 


String variables may be referenced (for input, 
output, manipulation, or comparison) in their 
entirety or by parts (substrings). For example, if 
the string variable A$ equals "SUBSTRING EXAMPLE", 
substrings of AS include "SUB",’"UBSTR", "G EXA", 
and any other part of the string. 


Substrings are referenced by subscripting string 
variables. The four formats for referencing string 
variables are discussed here. In these formats 
svar refers to a string variable name (refer to 
section 5.2.1) and aexp-l and aexp-2 are arithmetic 
expressions, variables, or constants. If the 
string variable has not been explicitly 
DiMensioned, it can be considered to have an 
implicit DIMension of 19. 


Format-l: svar 


On input (INPUT or GET), if a string variable is 
referenced without subscripts, the entire string is 
referenced by implication. This means that all 
characters, @ through the DIMension of the string 
are referenced. On output (PRINT or PUT), if a 
string variable is referenced without subscripts, 
the string is referenced from the first character 
(character number @) through the last non-null 
character. This is the same as saying that the 
string is referenced from character number @ for a 
length LEN (see the LEN string function). 


Summary — 

On input, if no subscripts are used, the 
entire string variable is referenced as 
dimensioned. 

On output, the string is referenced from 


character @ through the last non-null 
character. 
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5.2.3.2 Format-2: svar(aexp-1) 


5.203% 3 


If a single subscript is used it must be greater 
than zero and less than or equal to the DIMension 
of the string variable. This format defines a 
substring which starts with the character in 
position aexp-1l and includes all subsequent 
characters in the string through the DIMensioned 
value (input) or through the last non-null 
character (output). If, on output, a character 
position greater than the LENgth of the string is 
explicitly referenced, then all subsequent null 
characters are referenced by implication. 


If aexp-l is equal to zero or less, the entire 
string will be referenced (character @ through the 
DIMensioned value). 


If aexp-l is greater than the DIMension of the 
string variable, a run time error message will 
result. 


Summary — 


If one (aexp-1) subscript is used, the 
substring referenced starts with 
character in position aexp-l and includes 
all subsequent characters in the string 
through the DIMension value (input) or 
through the last non-null character 
(output). 


® < aexp-l < DIMension of svar 


Format-3: svar(aexp-l,aexp-2) aexp-2 > @ 


In this format, aexp-l must be greater than or 
equal to zero and less than the DiIMension of the 
string variable. Thus, aexp-l defines the starting 
character of the substring as it did in format-2. 


The second subscript (aexp-2) must be greater than 
the first subscript (aexp-l1) and less than or equal 
to the DIMension of the string variable. Now, 
aexp-~2 defines the final character of the 
substring. 


If either aexp-l or aexp-2 exceeds the DIM value of 
the string variable, a run time error will result. 
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5.2.3.4 


If aexp-l is less than zero, the entire string is 
referenced as though no subscripting had been used 
(see format-l). 


If aexp-2 is less than aexp-1, aexp-l will be the 
starting character of the substring and the 
DIMensioned value will be the final character (as 
though format-2 had been used with aexp-l). 


Refer to format-4 if aexp-2 is less than zero. 


Summary - 

If two subscripts (aexp-l, aexp-2) are 
used, the second subscript being 
positive, the substring referenced starts 
with character in position aexp-1 and 
ends with character in position aexp-2. 


® < aexp-l < aexp-2 < DIMension of svar 


Format-4: svar(aexp-1l,aexp-2) aexp-2 < @ 


In this format, aexp-l must be greater than zero 
and less than the DIMension of the string variable. 
Thus, aexp-l defines the starting character of the 
Substring as it did in format-2 and format-3. 


The second subscript (aexp-2) must be less than 
zero and its absolute (positive) value must, when 
added to aexp-l not exceed the DIMensioned value of 
the string variable. In this case, the absolute 
(positive) value of aexp-2 indicates the length or 
number of characters included in the substring. 


If aexp-l plus the absolute value of aexp-2 is 
greater than the DIMensioned value of the string 
variable, a run time error will result. 


If aexp-1 is less than zero, the entire string is: 
referenced as though no subscripting had been used 
(see format-l). 


Refer to format-3 if aexp-2 is equal to or greater 
than zero. 
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Summary — 

If two subscripts (aexp-l, aexp-2) are 
used, the second subscript being 
negative, the substring referenced starts 
with character aexp-l and continues for a 
length of |aexp-2]|. 


®@ < aexp-l < DIMension of svar 
aexp-l + |aexp-2] < DIMension of svar. 


Note: 


If aexp-2 is equal to %8098% then aexp-2 is 
considered to be equal to -@ (minus zero) and will 
produce a string of length zero (i.e., a null 
string). 


Examples: z 


Assume that the command A$ = "ABCDEFGHIJK" has been 
given and that the string variable A$ has not been 
DIMensioned in a DIMension instruction (it is 
implicitly DIMensioned at 19 and it contains 11 
characters numbered zero through ten). 


Instruction Result Explanation 
PRINT AS ABCDEFGHIJK Format-l was used to PRINT the 


entire string. 


PRINT AS (5) FGHIJK Format-2 was used to PRINT the 
substring starting with 
character 5 (remember that the 
characters are numbered 
starting with 9). 


PRINT A$ (4,8) EFGHI Format-3 was used to PRINT the 
substring starting with 
character 4 and ending with 
character 8. 


PRINT AS (3,-2) DE Format-4 was used to PRINT the 
substring starting with 
character 3, for a length of 
two characters. 


Now assume the command AS = "ABCDEFG" has been given. This 
will fill the string with the seven characters A-G and 4 null 
characters. In the following examples the lower case n 
represents a null character. : 


ON, 
f 
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Instruction Result 
PRINT AS ABCDEFG 
PRINT AS (-1) ABCDEFGnnnn 


PRINT 


PRINT 


PRINT 


PRINT 


PRINT 


PRINT 


AS (8) nnn 
AS (5) FG 
AS (5,2) FGnnnn 


AS (8,9) nn 


AS (13,15) 


AS (3, 389003) 


Explanation 
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Format-l was used to PRINT 
character @ through the first 
non-null character. 


Format-2 (with a negative 


argument) was used to PRINT 
characters @ through DIM. 


Format-l was used to PRINT 
characters 8 through 19. Note 
that character 8 is greater 
than the LENgth of AS so that 
all succeeding nulis are 
referenced by implication. 


Format-2 was used to PRINT 
character 5 through the last 
non-null character. 


Format-3 was used with 
aexp-2<aexp-1l so the string was 
output from character 5 through 
the DIMension of the string. 


Format-3 was used to output 
characters 8 through 9. 


Format-3 error, aexp-l>DIM. 


A length of -@ indicates a null 
string, no string is output. 
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OPERATORS 
An operator is a symbol or group of letters which 
indicate that an action is to be taken on one or 
two items. This section describes the types of 
operators used in 16K BASIC and the symbols which 
represent them. 
Arithmetic Operators 


The arithmetic operators are analogous to their 
algebraic counterparts: 


Arithmetic 
Operator Meaning 

+ plus sign (positive number) 
- minus sign (negative number) 

** or * exponentiation 
* multiplication 
/ division 
+ addition 


Subtraction 


Arithmetic operations in a numeric expression are 
performed, according to the priority of the 
operation, from left to right. All operations 
enclosed within parentheses are performed first. 
When multiple sets of parentheses appear, the 
operations in the innermost set of parentheses are 
performed first, followed by the operations in the 
next set of parentheses, and so on until the 
operations in the outermost set of parentheses are 
evaluated. Following evaluation of expressions 
enclosed in parentheses, arithmetic operations are 
performed in the following order: plus and minus 
signs (unary operators), exponentiation, division 
and multiplication (these two operations have the 
same priority), and addition and subtraction (these 
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operations also have the same priority). When 
operations have the same priority, calculations are 
performed from left to right within the expression. 
The use of parentheses can alter the order in which 
operations are performed since the parentheses 
override both the left to right priority and the 
normal order of operations. 


Examples: 
A+B* C ** DP 


The above expression will be evaluated as follows: 


temp = C ** D 
templ = temp * B 
final value = templ +A 


The order of association can be changed by the use 
of parentheses: 


(CAB). 2) re 


This expression will be evaluated as follows: 


temp = A +B 
templ = temp * C 
final value = templ ** D 


It is a good idea to use parentheses if there is 
any doubt as to the order in which a series of 
operations will be performed. Intermediate results 
may also be assigned to temporary variables if this 
will help to clarify the order of operations. 


Assignment Operator 


The equal sign (=) is the assignment operator. It 
is used to assign the value of an arithmetic, 
relational, or boolean expression, or a function, 
to a numeric variable. 


In addition, the assignment operator is used to 
assign the value of a string literal, string 
variable, or string function to a string variable. 


BASIC also uses the equal sign as a relational 
operator (see the following section). The only 
place the equal sign is a legal assignment operator 
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is the first equal sign in a LET, implied LET, or 
MAT instruction. 


Examples: 


190 A = 2 

119 PRINT A 

129 A = A*2 

130 IF A = 16384 THEN STOP 
148 GOTO 119 


This program will print out all of the powers of 2 

- which are less than 16384 and then it will stop. 
Statement 109 pep agns the value of 2 to the numeric 
variable A, 


Line 120 assigns the result of the multiplication 
of the variable A times the constant 2 to the 
variable A. This is a good example of the reason 
the term assigned to is used instead of equal to. 
A is obviously not equal to A times 2, The 
expression on the right side of the assignment 
operator is evaluated (A * 2) and then this value 
is assigned to the variable on the left of the 
assignment operator. 


Statement 138 uses the equal sign as a relational 
operator. The relational expression (A=16384) is 
evaluated as true or false. If it is true, the 
portion of the instruction following THEN is 
executed (program execution STOPs). If it is 
false, the next succeeding statement (149) is 
executed. Refer to the following section for a 
further discussion of relational operators. 


Line 148 transfers control back to line 118 and 


execution continues until the relational expression 
(A = 16384) is true. 


1g AS = "REND" 

29 PRINT "Enter a name," 
38 PRINT "END to stop"; 

49 INPUT GS 

5@ IF G$ = A$ THEN STOP 

68 PRINT GS : PRINT 

78 GOTO 2 


Statement 18 assigns the value of the string 
literal "END" to the string variable A$. Line 4@ 
gets a string from the user and assigns the value 
of that string to the string variable GS after 
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having set GS equal to a string of null characters 
(see the INPUT instruction). 


Statement 5@ uses the equal sign as a relational 
operator. The relational expression (GS = AS or we 
could have used G$ = "END") is evaluated as true or 
false and the execution of the program continues on 
the basis of the evaluation. See the next section 
for more on relational operators. 


Relational Operators 


Relational 
Operator Meaning 

= is equal to 
< is less than 
> is greater than 
<= is less than or is equal to 
>= is greater than or is equal to 
<> or # is not equal to 


Relational operators are used to compare two 
expressions. Each of these expressions may be 
composed of other relational, boolean, or 
arithmetic expressions. This allows the user to 
nest relational and boolean expressions. 


In addition, relational operators are used to 
compare string variables, string literals, and 
string functions with each other. 


The result of a relational operation is either true 
(=1) or false (=@). 


Examples: 


199 IF A<=8 GOTO 158 
118 PRINT A=@ 

126 B=A<@ 

138 C=A=5 

15@ END 


Statement 198 can be read as, "If the value of the 
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variable A is less than or is equal to zero, 
transfer program control to line 158; otherwise 
continue with the next statement (line 118)". This 
is the most common use of a relational operator, 
This statement can be used to test the validity of 
user input, transferring control to another section 
of code if the input is not as desired. 


Statement 118 may at first look like an improper 
assignment instruction, Remember that the equal 
sign is, in this case, a relational operator, not 
an assignment operator. This statement can be read 
as, "Compare the value of A with @ and print the 
result of the comparison". Thus, a zero (=false) 
will be output if A is not equal to zero and al 
(=true) will be output if A is equal to zero. 


Statement 128 is similar to 119, with the exception 
that the result of the relational comparison is 
assigned to the variable B. B will therefore take 
on a value of @ or 1. 


Statement 138 is a combination of the procedures 
used in 118 and 120. Remember that the first equal 
sign is an assignment operator while the second 
equal sign is a relational operator. This 
Statement can be read as, "Compare the value of the 
variable A with five and assign the result of that 
comparison to the variable C". cC will take on the 
value of 1 (=true) if A is equal to five, otherwise 
C will be set equal to ® (=false). 


308 SS = "zzz" 

305 INPUT QOS 

318 IF Q$ > S$ THEN GOTO 365 
315 ss = Q$ 

328 PRINT S$ 

325 GOTO 395 


Line 398 initializes the string variable s¢$ by 
filling it with z's (the alphabetic character with 
the highest value in the ASCII collating sequence). 
Line 385 requests string data from the user. 


Statement 318 evaluates the relational expression 
(Q$>S$) on the basis of the ASCII collating 
sequence (refer to the table of ASCII characters in 
the appendix). If the first character in the 
String Q$ is different from the first character in 
the string S$ then these characters are compared 
and this relationship determines the relationship 
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of the two strings. If the first character in each 
string is identical to the other, the comparison 
Moves on the second character and so on. For 
example: 


Value of 

Expression 
Value of QS Value of S$ Q$>s$ 
George Fred false 
Fred April true 
April Ted false 
april Ted true 
april ted false 
april ; apron false 
april apricot true 
april aprilandmay false 


Notice that all lower case letters follow the set 
of upper case letters in the ASCII collating 
sequence and that if two strings are the same 
except for length, the longer string has a greater 
value than the shorter one. 


Continuing with the example, if the relational 
expression (line 318) is evaluated as true, control 
is transferred to line 305 and the user is asked 
for another string. If the expression is false, 
this means that the string which was just INPUT by 
the user is closer to the beginning of the ASCII 
collating sequence than any other string which had 
been INPUT previously. The value of this string is 
then assigned to the string variable SS so that all 
strings which are INPUT following this one can be 
compared with it. The value of the string is then 
PRINTed and control is transferred to line 3865. 
Execution of this program may be terminated by 
depressing the ESCape key. 
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Operators 
Boolean Operators 
Boolean 
Operator Meaning 
AND logical AND 
OR logical OR 
XOR logical eXclusive OR 
NOT logical NOT or negation 
Boolean operators perform a logical operation on 
one or two expressions. The expressions in a 
boolean operation may take on one of two values: 
false (=@) or true (=1). In Cromemco 16K Extended 
BASIC, all values which are not equal to zero 
(false) are considered to be true (=1) when used 
with boolean operators. 
AND Boolean Operator 
The AND boolean operator compares two logical 
values and if both are 1 returns a result of l. If 
both values are not 1, then the result is @. 
Truth Table 
AND 4 1 
g O Y) 
1 i) 1 
OR Boolean Operator 
The OR boolean operator compares two logical values 
and if either or both are equal to 1 then the 
result is 1. Otherwise the result is @. 


Truth Table 


en Lo 
ee 
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XOR Boolean Operator 

The XOR boolean operator returns a @ if the logical 
values are identical and a 1 if the logical values 
are not identical. 


Truth Table 


XOR i) 1 
4) 1 1 
1 1 B 


NOT Boolean Operator 


The NOT boolean operator returns the compliment of 
any logical value. In other words, if the logical 
value is 1, the NOT operator returns a @. If the 
logical value is 8, a 1 is returned. 


NOT Truth Table 
NOT @ is l 


NOT 1 is @ 


Examples: 


1W®A=1: B=@: Al=zl1l: Ble=l 

11 IF A AND A THEN PRINT "11 TRUE" 

12 IF NOT A THEN PRINT "12 TRUE" 

13 IF NOT B THEN PRINT "13 TRUE" 

14 IF A XOR A THEN PRINT "14 TRUE" 

15 IF NOT (A XOR A) THEN PRINT "15 TRUE" 
16 IF A OR B THEN PRINT "16 TRUE" 


The statements above give some examples of the use 
of boolean operators. The IF...THEN instructions 
are used in these examples to test if a given 
boolean expression is true or false. If the 
expression is true, the PRINT instruction following 
the IF...THEN is executed. If it is false, then 
nothing is printed. 


The results of each of these expressions can be 
determined from the preceding truth tables. For 
example, line 14 uses the XOR operator to compare 
two true (=1) values. Looking at the xXOR Truth 
Table, it can be seen that a 1 and al yield a @ or 
false value. Line 15 negates this same expression. 
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Looking at the NOT Truth Table, NOT @ (Not false) 
is seen to be equal to 1 or true. 


The results of the rest of the examples can be 


determined in a similar manner, then tested on the 
computer, 


By 
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PROGRAMMING EXAMPLES 


The examples in this chapter are intended for the 
first time user. They explain in step by step 
detail the procedures for creating, editing, and 
saving a BASIC program. If a more detailed 
description of a BASIC instruction is required, the 
reader is referred to the chapters of this manual 
which cover the instructions on an individual and 
in depth basis. 


It is recommended that the novice BASIC user go 
through this section while seated in front of a 
terminal, with BASIC up and running. This way, 
each instruction and program can be tried out as it 
is presented. 


When BASIC is loaded into a minimum disk system 
configuration with 32K bytes of memory, the space 
available to the user should be 1.5K bytes. The 
other 3@.5K bytes are occupied by BASIC, the 
console processor, CDOS I/O routines, etc. For 
ways to increase the user space, see the notes at 
the end of the manual, specifically: Changing the 
Number of I/O Channels. 


Note: It is important to remove disks from the 
disk drive before turning the power on or off. 
This will eliminate the possibility of stray bits 
being written on the disk as the system is powered 
up or down. 


Getting Started 


After the computer has been turned on, the floppy 
diskette containing BASIC and the Cromemco Disk 
Operating System (CDOS) must be inserted into disk 
Grive A. This is the leftmost disk drive. Start 
with the diskette supplied by Cromemco. The 
diskette should be inserted so that the label faces 
left and the edge with the elongated hole which 
exposes the surface of the diskette is toward the 
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rear of the machine (disk drive). If there is a 
door on the disk drive it must be closed after the 
diskette is inserted. 


Next the RETURN key on the console must be 
depressed several times so that the computer can 
determine the speed at which the console is sending 
characters (baud rate). The computer will respond 
to this by displaying a character on the console 
(called a prompt) which indicates that it is 
waiting for the user to type something. If the 
prompt is a semicolon (;), the user must type B 
(for Boot) followed by a carriage RETURN to load 
CDOS into memory. If the prompt is the letter A 
followed by a period (A.) then the Cromemco Disk 
Operating System (CDOS) has already been loaded 
into memory. 


The terminal must be set up so that it will only 
send BASIC upper case characters. If you are using 
one of the Cromemco 3198 series terminals, depress 
the ALPHA LOCK key so that the red light on the key 
is lit. You will now be in upper case mode. 


In response to the CDOS prompt, type BASIC followed 
by a carriage RETURN. After a few seconds the 
BASIC sign on message will be displayed followed by 
the BASIC prompt (>>). BASIC has now been loaded 
into the computer's memory and is waiting for 
instructions. 


One Very Important Point follows: 


ALL LINES ENTERED IN BASIC MUST BE TERMINATED BY 
DEPRESSING THE CARRIAGE RETURN KEY. 


BASIC will never respond to an instruction, accept 
any input, or complete a command unless it is 
terminated by a carriage RETURN. If BASIC does not 
seem to be responding as you think it should, make 
Sure that you have properly terminated the current 
line (with a carriage RETURN). 
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The Command or Immediate Mode 

Whenever the BASIC prompt (>>) is displayed, BASIC 
is in the Immediate Mode. This means that an 
instruction (command) can be entered and BASIC will 
respond immediately after the carriage RETURN is 
depressed. 


The first instruction we will discuss is PRINT. 
PRINT causes BASIC to display the information 
following the word PRINT. Using only the PRINT 
instruction, and the standard Arithmetic Operators 
(+ for addition, - for subtraction, / for division, 
and * for multiplication), BASIC may be used as a 
calculator. 


Instruction Explanation 


PRINT 5 This will PRINT the number 5. 
Since there is nothing 
following the 5 BASIC will add 
a carriage RETURN and LINE FEED 
so that the next item which is 
PRINTed will start in column @ 
of the following line. 


PRINT 7 + 4 This will PRINT the result of 
adding 7 and 4, or ll. 


PRINT "FRED" This will PRINT the word FRED. 
Notice that if a group of 
letters (called a string) are 
to be PRINTed, they must be 
enclosed in quotation marks. 
When a string is enclosed in 
quotation marks, it is called a 
string literal. Numbers 
(called constants) which are to 
be used in a computation may 
not be enclosed in quotation 


marks. 
PRINT This will PRINT a blank line. 
PRINT 1,2,3,4 This will PRINT the numbers 1 


through 4 in four columns 
across the screen. When commas 
(,) are used to separate items 
in a PRINT list, the items are 
aligned in four columns across 
the console screen. Tf 
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semicolons (;) are used, the 
items are displayed with no 
intervening spaces. 


PRINT "ANS. = ";75 This will display ANS. = 75 on 
the console. Notice that a 
blank was included after the 
equal sign in the string 
literal. This blank is 
considered part of the string 
literal, just as any other 
character, 


Next we will discuss variables and the Assignment 
Operator (Instruction). A variable is the name of 
a location in the computer's memory. While the 
name of a variable stays the same, the contents of 
the variable (location) may vary. 


A variable name may be thought of as a label which 
has been affixed to a box. If we are speaking of 
an arithmetic variable, then the box would contain 
a number. The number inside the box is the VALUE 
of the variable. The value of the variable can be 
changed while the name of the variable stays the 
same. Similarly, a string variable would contain a 
string of characters which could include letters, 
spaces, numbers, and any other printable 
characters. This combination of characters would 
be the value of the string variable. 


Arithmetic variable names are composed of either a 
Single letter (A-Z) or a single letter followed by 
a single number (8-9). Some examples of arithmetic 
variables are Al, B8, Z@, 04, V, A, etc. 


String variables may use any name which is a legal 
arithmetic variable name, however, a dollar sign 
must immediately follow the name. Some examples of 
string variables are G8$, YS, PS, T1S, M9S, etc. 


The assignment operator assigns a value to a 
variable. The equal sign (=) is used for this 
purpose. In BASIC, the equal sign can be read as, 
"is assigned the value of". Notice that it does 
not necessarily denote equality. 
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Instruction 
GS = "FRED" 
PRINT GS$ 

P4 = 775 

P4 = P4 +1 
oss = " ITS NO. 
Z7$ = Q5$ 


PRINT GS; 27S; 


P4 


Explanation 


The value of the string literal 
"FRED" is assigned to the 
string variable named GS. 
Notice that, although the 
string literal "FRED" must be 
enclosed in quotation marks, 
the quotation marks are not 
part of the string variable. 
The quotation marks indicate to 
BASIC that the enclosed 
characters are to be considered 
a string literal. 


This instruction will display 
the value of GS on the console. 
If this instruction follows the 
preceding one, FRED will be 
PRINTed on the console 
terminal. 


The variable named P4 is 
assigned the value of 775. 


P4 is assigned the value of P4 
+ 1. If this instruction 
follows the previous one, P4 
will have the value of 776. 


The string variable Q5$ is 
assigned the value of the 
string literal " IS NO. ". 


The string variable Z7$ is 
assigned the value of the 
string variable Q5S. 


will print FRED IS NO. 776 
(assuming it follows the above 
assignment instructions). 


An important distinction: The user must be careful 
to distinguish between a string literal and the 
name of an arithmetic variable. The following 
table should help to clarify this difference, 
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Instruction Explanation 


A = 54 The variable named A is 
assigned the value of 54. 


PRINT A This will PRINT the number 54 
which is the value of the 
arithmetic variable A. 


PRINT "A" This will PRINT the letter A 
which is the value of the 
string literal. 


The next instruction we are going to discuss is the 
INPUT instruction. When executed, this instruction 
displays a question mark on the console and waits 
for the user to supply a number or a string. 


Instruction Explanation 


INPUT A This command will display a 
question mark and wait for the 
user to enter a number. The 
number which is entered will be 
assigned to the variable named 
A. 


INPUT QS This command will display a 
question mark and wait for the 
user to enter a string (any 
group of characters, in this 
case up to a maximum of 
eleven). The value of the 
string which is INPUT will be 
assigned to the string variable 
named QS. 


Up to this point, all of our examples have been 
executed as commands or in what is referred to as 
the immediate mode. Each command was executed as 
soon as the carriage RETURN was depressed. Once 
executed, the entire instruction had to be typed 
again in order to be re-executed. 


Now we shall use these same instructions to write a 
program. A program consists of statements. A 
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statement is nothing more than an instruction with 
a line number preceding it. Line numbers are also 
called statement numbers; the two terms are 
interchangeable. The line number indicates to 
BASIC that the instruction is to be stored in 
memory for later execution. A line number is also 
a handy way to refer to a BASIC statement if it 
needs to be changed. 


Let us enter a program: 


>>10@ INPUT AS 
>>200 PRINT AS; " is smart!" 


This program is now current in the User Area. The 
User Area is the BASIC workspace in which a program 
can be written, edited, and run. The LIST command 
displays the contents of the User Area. 


The RUN command causes BASIC to execute the program 
in the User Area. Program execution begins with 
the statement with the lowest line number and 
continues sequentially. 


Now, we can execute the program: 


>>RUN 

? Tom BASIC displays the ? (prompt) 
and the user enters a string. 
Don't forget the carriage 
RETURN at the end of the 
string! 


Tom is smart! BASIC PRINTs the string 
variable (Tom) and the string 
literal ( is smart!). 


**KEND*** BASIC tells you that it's done 
with the program, 


>> and that it is ready for 
additional instructions. 


To get a LISTing of your program, type the command 
LIST in response to the BASIC prompt. 


>>LIST 

198 INPUT AS 

2008 PRINT AS;" is smart!" 
>> 
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Activating the System Printer 


The printer (if one is attached to your system) is 
activated by typing control-P. Control-P is typed 
by holding down the CTRL key on your terminal (as 
you would hold the shift key on a typewriter) and 
Simultaneously depressing the P key. 


Anytime CTRL-P is typed, the system printer 
automatically echoes any input, output, or LISTing 
which is sent to the console. 


To LIST the program which is current in the User 
Area, enter: 


>>LIST (CTRL-P) (CR) 


on the console. The LISTing will be sent to the 
console as well as the printer. When the LISTing 
has terminated, type CTRL-P before anything else is 
entered. This will ensure that nothing else is 
output to the printer following the LISTing. 


Anytime the printer is on and is echoing the 
console, typing CTRL-P will turn off the printer. 


If CTRL-P is inadvertently typed, and there is no 
system printer, or the printer is off, type a 
second CTRL-~P to resume normal operation. If this 
is not done, the system will wait for a printer 
before displaying any additional output on the 
console. 


66 


CROMEMCO 16K EXTENDED BASIC INSTRUCTION MANUAL 
7. Programming Examples 


Program Editing 


Continuing with the same program, we wish to alter 
a statement. 


To change a line, type it over again. When BASIC 
recognizes that it already has a line with the same 
line number, it will replace the old line with the 
new one. To delete a line, type the line number 
followed by a carriage RETURN. Suppose we wanted 
to change line 209: 


>>20@ PRINT AS; " is very smart!!!" 


>>LIST After making the change, we can 
list the program to make sure 
that we changed it properly. 


108 INPUT AS 
208 PRINT AS;" is very smart!!!" 


>> Again, BASIC waits for further 
instructions. 


Suppose that, instead of executing these statements 
only once, we wanted them executed several times. 
We could type RUN each time the program was to be 
executed, or we could add another statement which 
would direct BASIC back to the beginning of the 
program each time it finished PRINTing: 


>>3088 GOTO 188 This GOTO tells BASIC to GOTO 
statement number 198 and 
continue executing from there. 
>>LIST 
188 INPUT AS 
200 PRINT A$;" is very smart!!!" 
388 GOTO 1900 


>>RUN 
? Alice Don't forget the carriage 
RETURN! 


Alice is very smart!!! 


? Eileen After it was done with 
statement 208, statement 368 
told BASIC to go back to 
statement 188, which gave us 
another question mark. 
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Eileen is very smart!!! 


7 


This could (and would) go on 
forever. This can be avoided 
by depressing the ESCape key 
(appropriately named). On a 
Cromemco terminal this key is 
located on the upper left of 
the keyboard and is marked 
ESC. 


***19Q ESCAPE*** 


>> 


BASIC tells you what happened, 
and waits for further 
instructions. 
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Example Program One 


Let's write a program to compute a person's age in 
the year 1985. For this program, we will introduce 
two new instructions. The first of these is SCR 
which is short for SCRatch. This instruction 
clears memory of a program or any statements which 
may be in the User Area: 


>>SCR 

>>LIST Nothing will be listed, because 
everything has been SCRatched! 

>> 


The other is AUTOL which is short for AUTOmatic 
Line numbering. This is a convenient feature of 
Cromemco 16K BASIC which allows the programmer to 
concentrate on the program and forget about 
entering line numbers. AUTOL is followed by two 
numbers (called arguments). The first of these 
indicates the first line number, while the second 
indicates the increment between line numbers. In 
the following example, the line numbers are 
automatically typed by BASIC while the program is 
entered by the user: 


>>AUTOL 1908,19 


>>1000 PRINT"Enter the year of your birth: "; 
>>1819 INPUT Y 


>>1920 PRINT"In 1985 you will be ";1985-y;" years o1d" 


>>1630 PRINT 
>>1948 GOTO 1890 
>>1850 

>> 


There are several things about this program which 
bear discussion. The first is that the AUTOmatic 
Line numbering mode may be terminated by entering a 
carriage RETURN (our old friend) in response to a 
line number. Line 1928 PRINTs two strings with a 
number in the middle. The number is the result of 
a computation: the numeric variable yY is 
subtracted from the numeric constant 1985. Line 
1938 is included so that there will be a blank line 
PRINTed between examples. 
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. The program we have written will stay in memory (in 


the User Area) as long as we don't execute the 
SCRatch command or turn the power off. 


We may write the program to a disk file so that it 
may be retrieved at a later time. Once it has been 
LISTed on the disk, we may SCRatch the user area or 
turn the power off and our program will still be 
safe on the disk. 


The only way a disk file can be destroyed is by 
ERASing it or by writing another file with the same 
name to the disk. In the latter case, the second 
file would be written over the first so that the 
first file would be destroyed. 


The LIST command, as we have been using it, LISTs 
the contents of the User Area to the console. If 
the LIST command is followed by a string literal, 
BASIC will interpret the string literal as a file 
name, and LIST the contents of the user area to 
that file. Assuming that our program is still in 
the User Area, the following command will write the 
program to a file called FIRST. 


>>LIST "FIRST" 


>> 


The disk should come to life, click once or twice, 
and another prompt should appear on the console. 
If BASIC has done your bidding, the DIRectory 
command will reveal a file on the disk called 
FIRST. To get a list of all the files on the disk 
enter the command: 


>> DIR 


BASIC will respond with a list of file names, 
including FIRST. Now you can shut off the computer 
without losing your program. 


Remember to remove the disk before turning the 
power off. It is also a good idea to insert the 
disk only after the power has been turned on. Do 
not turn the power on or off while the disk is 
inserted in the machine. 
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A program which has been LISTed to a disk file may 
be re-entered by using the ENTER command. 


Before entering any program, whether from a disk 
file, or from the console, it is a good idea to 
SCRatch the User Area. Assuming that we are once 
again (or still) in BASIC, we can give the 
following two commands to clear the User Area and 
enter our program which was saved in the disk file 
FIRST. 


>> SCR 


>> ENTER "FIRST" 


>> 


Our program may now be LISTed, RUN, or modified as 
we desire. 
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Example Program Two 


Let's try another example. First we will type SCR 
to clear the user area, and then AUTOL to start the 
AUTOmatic Line numbering: 


>> SCR 
>> AUTOL 18,120 
Next, type in your first instruction: 


>>18 LET N = 5 


When the program is RUN, this instruction will 
assign a value of 5 to the variable N. BASIC will 
remember this value and it will remain the same 
until redefined by the user or by an algorithm 
within the program. BASIC will also understand the 
statement above without the LET, as: 


>>18 N = 5 


This is called an implied LET and is a 
characteristic of advanced versions of BASIC. 
BASIC will also disregard spacing of characters in 
statement lines. Thus, the statement: 


18 LET N = 5 
is equivalent to the statement: 
1@ LET N=5 


At this point, we have the following line on the 
terminal: 


>>AUTOL 16, 128 
>>16 N = 5 


BASIC is waiting for our next instruction. Type 
in: 


>>20 INPUT A: INPUT B: INPUT C: INPUT D: INPUT 


With this long statement line, we have created a 
set of instructions that will ask for five numbers 
(inputs A,B,C,D, and E) when the program is run. 
In 16K BASIC, more that one instruction can be 
associated with a line number. These instructions 


72 


CROMEMCO 16K EXTENDED BASIC INSTRUCTION MANUAL 
7. Programming Examples 


a 
Ke 
must be separated by colons. Multi-instruction 
statement lines save memory space. 
Next, we enter the statement: 
>>30 X = (A+B+C+D+E) /N 
This assigns the value of the sum of the five INPUT 
numbers divided by the value of the variable N to 
variable xX. The variable X is therefore the 
average of these five values. We defined N as 5 
previously. If we had not defined N, then it would 
be assumed that N = @. 
Naturally, we'll want to look at X to see what it 
is. We type in: 
>>48 PRINT X. 
which instructs BASIC to print that value of X when 
the program is run. What do we have so far? Our 
program, as listed below, looks ready to run. 
\ >>AUTOL 18, 19 
>>18 N= 5 
>>2@ INPUT A: INPUT B: INPUT C: INPUT D: INPUT E 
>>38@ X = (A+B+C+D+E) /N 
>>4@ PRINT X 
16K BASIC does not require an END or STOP, but it 
is good programming practice to include one. So we 
can add the following statement to our program: 
>>5@ END 
If we wanted to run through the program a number of 
times, finding means for many groups of five 
numbers, we might have entered: 
58 GOTO 19 
This would instruct BASIC to return to line 1@ and 
re-execute the program, finding the mean of five 
new numbers each time. To escape from such a loop, 
or from a program during its execution, press the 
ESCape key on your terminal or teletype keyboard. 
a Now let's run the program. After statement line 59 


is typed in we depress the carriage RETURN in 
response to the next line number to get out of the 
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AUTOmatic Line numbering mode. Then we type in: 
>>RUN 


This command instructs the computer to begin 
execution of the program. When the first INPUT 
command in line 2@ is encountered during program 
execution, a question mark (called a prompt) will 
appear on your terminal, as indicated below: 


>>RUN 
? 


This prompt indicates that the computer is waiting 
for you to input a number for the first variable in 
the INPUT statement. We therefore type in: 


2 LF 


and BASIC responds with: 


e279 
cs 


The second prompt indicates that the computer is 
waiting for a value for INPUT B. In fact, we need 
to enter values for the next four INPUT variables. 
Once we input these values and depress the carriage 
RETURN, the computer will complete program 
execution and PRINT out the value of xX, as shown 
below: ; 


*kk*ESQ END*** 


Almost instantly, the BASIC program has calculated 
and printed the average of the five numbers we 
input. This average is 17. At this point, we 
might want to do a little formatting to change the 
way in which the results are printed out. We LIST 
the program again to see what we have to work with. 
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>>LIST 


18 N= 5 


26 INPUT A: INPUT B: INPUT C: INPUT D: INPUT E 


30 X = (A+B+C+D+E) /N 
40 PRINT X 
5@ END 


We can start by inserting some lines within the 
present text of the program. At any time, lines 
can be inserted between present statements by using 
a number which falls between two line numbers. For 
example, a line numbered 15 will be inserted 
between statement number 18 and statement 29. When 
a program is RUN or LISTed, the new statement lines 
are automatically inserted into the proper space in 
the hierarchy. 


We decide to add spaces between lines to make 
reading easier. We add: 


>>15 PRINT 
>>16 PRINT 
>>35 PRINT 
>>36 PRINT 


Inserting a PRINT instruction in a statement line 
without text to be printed generates a linefeed. 
At this point, you'll want another look at the 
program. BASIC will have sandwiched the new 
statement lines into the old text as shown below: 


> >LIST 


1@ N= 5 
15 PRINT 
16 PRINT 


2@ INPUT A: INPUT B: INPUT C: INPUT D: INPUT E 


30 X = (A+B+C+D+E) /N 
35 PRINT 

36 PRINT 

48 PRINT X 

5@ END 


Now type RUN. According to our program, the 
computer will skip two lines after you type in RUN 
and then wait for you to type in 5 numbers. Once 
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these numbers are input, the program instructs the 
computer to skip two more lines and then PRINT the 
result. This output appears on the terminal as 
follows: 


>>RUN 


eg VU OU cre) 
= 
(>) 


20 
RKKOG END*** 


Many more variations may be added. For example, 
the statement: 


5 PRINT "A PROGRAM TO CALCULATE THE" 
7 PRINT "AVERAGE OF 5 NUMBERS" 


will give you a title for this program. You might 
also replace line 49 with: 


48 PRINT "THE MEAN OF THESE NUMBERS IS mex 

If it becomes necessary to enter a line between two 
others whose line numbers are consecutive (say you 
need a line between lines 35 and 36), the RENUMBER 
command can be used to spread the line numbers 
apart. While a program is in the User Area, type 
the command: 

>> RENUMBER 

>> 


and BASIC will assign new line numbers starting 
with 18 and incrementing by 19. 
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The SAVE command will write the program which is 
current in the User Area to a disk file. The 
program will be in internal machine format unlike a 
program which is written to disk using the LIST 
command. The LOAD command is to the SAVE command 
what the ENTER command is to the LIST command. 
LOAD allows the user to read a SAVEd file into the 
User Area. Notice that LOAD cannot be used with a 
LISTed file and that ENTER cannot be used with a 
SAVED file. 


The formats of these commands are: 


>>SAVE "SECOND" 
>>LOAD "SECOND" 


When used with larger programs, SAVE and LOAD can 
be significantly faster than LIST and ENTER. Also, 
when the RUN instruction is given with the name of 
a SAVEd file, the specified file will be LOADed and 
RUN with only that one instruction. Programs may 
be chained in this fashion, one calling the next, 
calling the next, etc. 


>>RUN "SECOND" 
or 
9999 RUN "SECOND" 
The execution of either of these instructions will 


cause the SAVEd program SECOND to be LOADed into 
the User Area and execution to begin. 
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Example Program Three 
Active Bandpass Filter Calculation 


One of the most elementary applications for a 
computer is to use the computer to do calculations 
that can be done on sophisticated hand calculators. 
A program written to perform such calculations can 
be saved and reused as often as required. An 
example of a simple calculation program follows. 
This program allows the user to input data on 
certain parameters associated with the design of an 
active bandpass filter based on a common 
operational amplifier. The program then calculates 
the necessary component values based on the data. 


A BANDPASS 74I-TYPE ACTIVE FILTER 


Cl 


RI 


R2 


vt 


NOTE: NO PHASE RELATIONSHIP IMPLIED 
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The first three statement lines of the program are 
as follows. Notice that the at sign (@) is used 
instead of the word PRINT. When a lot of PRINT 
instructions are used, this can facilitate program 
entry. 


18 @ 
20 @"THIS PROGRAM CALCULATES DATA NEEDED TO CONSTRUCT" 
30 @"ACTIVE BANDPASS FILTERS USING 741-TYPE OP-AMPS." 


The principal function of PRINT statements 2@ and 
38 is to document the program so that it can be run 
in the future by users who are unfamiliar with it. 
All programmers should be encouraged to document 
programs thoroughly. 


The next step in the program is to request the user 
to input a number of values for various parameters. 
Note that each variable is defined in preceding 
PRINT statements. 


40 @ 
5@ @"WHAT IS THE CENTER FREQUENCY OF THE PASS BAND," 
68 @"IN HERTZ (E.G., 4000, 250, 68)"; 
88 INPUT F 
98 @ 
108 @"WHAT IS THE DESIRED GAIN, IN DECIBELS?" 
119 @"(E.G., 8, 5, 25)"; 
130 INPUT H 
148 @ 
158 @"WHAT IS THE DESIRED Q OF THE FILTER?"; 
178 INPUT Q 
188 @ 
198 @"SELECT A CONVENIENT STARTING VALUE C FOR" 
195 @"CAPACITORS Cl AND C2." 
200 @"IF THE VALUE IS IN PICOFARADS, ENTER THE DATA" 
218 @"IN THE FORMAT: X...E-12. IF THE VALUE IS" 
228 @"IN MICROFARADS, USE THE FORMAT: X...E-6." 
248 INPUT C 


In this schematic formula, Cl and C2 are equal. 
Once a value for C is specified, the resistor 
values can easily be found. The next step then is 
to specify the formulas for each resistor value, as 
indicated below: 


2580 @: @: @ 

280 @"RESISTANCE IN OHMS" 

2909 @: @ 

318 LET W=F*2*3.14159 

328 @ USING"R1]1 = #####htEE.EFE" ,O/ (H* WAC) 
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338 @ USING"R2 
348 @ USING"R3 
358 @ USING"R4 


HETHHTTTEH. EE" ,Q/ (( (2*0*O) -H) * (W*C) ) 
HHT H EEE H EEE" | (2*Q) / (WFC) 
HETHTHT EH. PEE" ,2* ((2*O) /(W*C) ) 


These formulas for Rl, R2, R3, and R4, specify the 
calculations which must be performed to determine 
the various resistances. The final section of the 
program provides a simple routine which allows the 
user to easily re-enter the program and input a new 
set of values. 


368 @ : @ 

388 @"WOULD YOU LIKE TO CALCULATE ANOTHER FILTER?" 
399 @"TYPE Y FOR YES"; 

41@ INPUT AS 

428 @:€@: @ 

450 IF A$S(®0,0)="Y"THEN GOTO 49 

469% END 


If the user does not wish to do another filter 

calculation and consequently types in a string 

starting with a character other than Y, then the 

program ends and BASIC returns to the immediate or 
command mode, 


Note that the variables in this program are given 
letter symbols that correspond to their function. 
For example, it is surely easier to remember that 
the Q of the filter is represented by variable Q 
than by variable L. Similarly the variable for 
capacitors Cl and C2 is C, rather than X or Y. 
These may seem to be intuitively obvious at this 
level of complexity, but as the program complexity 
increases the assignment of appropriate variable 
names becomes much more difficult. 


Once the program has been input, we can instruct 


the computer to execute the program by typing in 
RUN. The following output will be generated: 
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>>RUN 


THIS PROGRAM CALCULATES DATA NEEDED TO CONSTRUCT 
ACTIVE BANDPASS FILTERS USING 741~-TYPE OP-AMPS. 


WHAT IS THE CENTER FREQUENCY OF THE PASS BAND, 
IN HERTZ (E.G., 40090, 258, 68)? 1900 


WHAT IS THE DESIRED GAIN, IN DECIBELS 
(E.G., 8, 5, 25)? 26 


WHAT IS‘ THE DESIRED Q OF THE FILTER?? 1688 


SELECT A CONVENIENT STARTING VALUE C FOR 
CAPACITORS Cl AND C2. 

IF THE VALUE IS IN PICOFARADS, ENTER THE DATA 
IN THE FORMAT: X...E-12. IF THE VALUE IS 

IN MICROFARADS USE THE FORMAT: X...E-6. 

? 1.0E-6 ‘ 


RESISTANCE IN OHMS 


Rl = 795.775 
R2 = - 805 
R3 = 31831.016 
R4 = 63662.931 ; 


WOULD YOU LIKE TO CALCULATE ANTOHER FILTER? 
TYPE Y FOR YES? .NO 


*¥EKAG6Q END*** 
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Example Program Four 


Statistical Analysis Program 


Another common use for a computer is the 
calculation of statistics for a given set of data, 
particularly very large data sets. The program 
listed below calculates six common statistics for a 
given data set. 


One of the first steps that must be taken in any 
program is the assignment of variable names to any 
variables which will appear in the program. The 
following program involves six functions which will 
require variable names. These functions and the 
corresponding variable name used in the program to 
represent each function are listed below: 


Variable Name Function 
N Number of elements in a data set 
S Sum of the numbers in a dataset 
T Sum squares: 
M Mean 
Vv Variance 
dD: Standard Deviation 


We instruct the computer to keep track of the 
number of elements in a data set by including a 
counter variable in the program. In this case, the 
counter variable is N. To count the number of 
elements, we set N equal to @ initially and then 
increment N by 1 each time a new element in the 
data set is READ. Consequently, the first 
Statement lines are used to initialize (set equal 
to @) certain variables. 


18 LET N=@ 
28 LET S=@ 
3@ LET T= 


‘Note that S and T are also set equal to @. This 


will allow us to sum data elements and to sum the 
squares of data elements as the elements are READ. 
We can now begin reading in data elements. 
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48 READ X 

5@ IF X=999 THEN GOTO 1868 
68 LET N=N+1 

70 LET S=S+X 

88 LET T=T+ (X*X) 

98 GOTO 4G 

100 IF N=9 THEN GOTO 380 


The value 999 is used as a dummy value to indicate 
the end of a data set. The program continues to 
read in data and increment the values of the 
variables N, S, and T until a 999 is read from a 
DATA statement. Once a 999 value is read in, 
program control is transferred to statement line 
100. 


“Statement line 118 through 138 compute the 
remaining three statistics. 


119 LET M=S/N 
120 LET V=(N*T-S*S) /N/(N-1) 
139 LET D=SOR (V) 


a Next we include a set of titles to be printed out 
: with each statistic. 

140 PRINT 
15@ PRINT 
168 PRINT "NUMBER","SUM","SUM SQUARES" 
178 PRINT N,S,T 
189 PRINT 
199 PRINT "MEAN","VARIANCE","STANDARD DEVIATION" 
208 PRINT M,V,D 
218 PRINT 
220 PRINT 


At this point, all the statistics have been 
calculated for a set of data. Program control is 
therefore returned to the first statement in the 
program so that the next set of data can be read. 


258 GOTO 1 
268 DATA 1 
270 DATA 2 
28@ DATA 1 
298 DATA 9 
308 END 


a2 Once this program has been entered, edited, and 
a examined for errors, it can be RUN. The results 
are as follows: 
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>>RUN 
NUMBER 
18 
MEAN 
5.5- 
NUMBER 
“6 
MEAN 
2.55 
NUMBER 
8 


MEAN 
18.2125 


SUM 
55 


VARIANCE 
9.1666666666666 


SUM 
15.3 


VARIANCE 


0.835 
SUM 
145.7 


VARIANCE 
201.64696428571 


**4399 END*** 
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SUM SQUARES 
385 


STANDARD DEVIATION 
3.0276503549975. 
SUM SQUARES 

39.19 

STANDARD DEVIATION 
8.18708286933869 
SUM SQUARES 
4065.89 


STANDARD DEVIATION 
14.288245219211 
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7.6 Example Program Five 


296 
3808 
318 
326 
336 
349 
359 


REM This is a program which demonstrates 
REM the implementation of a Random 
REM Access File. 
REM 
REM The program creates and opens a file, writes 
REM 51 records sequentially, allows 
REM the user to repeatedly select any 
REM of the 51 records at random, and 
REM then closes and erases the file. 
REM 
DIM AS (21) 
INTEGER I,J 
CREATE" RANDTEST" 
OPEN\1,24\"RANDTEST" 
ON ERROR GOTO 226 
ON ESC GOTO 328 
PRINT"Pause, writing file RANDTEST" 

FOR I= TO 59 

PUT\1\"This is record number ",I 

NEXT I 
PRINT ; 
PRINT"Which record would you like to see?" 
PRINT"Enter record number (8-58) or -1 to stop: "; 
INPUT I 

IF I<@ THEN GOTO 320 

IF I>58 THEN GOTO 2190 
GET\1, I\AS (-1) ,J 
PRINT"Contents of record number ";I;" is:" 
PRINT AS;J 
PRINT 
GOTO 239 
CLOSE 
ERASE" RANDTEST" 

PRINT :; PRINT : PRINT"File RANDTEST erased" 
END 


On line 138, the file RANDTEST is CREATEd. If a 


file 


does not exist in the directory, it must be 


CREATEd before it can be OPENed for reading or 
writing. The file is OPENed on line 149 with a 
record length of 24 bytes which are allocated as 
follows: 


Line 


22 bytes for the string, and 
2 bytes for an integer : \ 


15@ ensures that any run time error (such as 


an invalid user response) will return control to 
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the user within the program and will not cause the 
program to terminate abnormally. Because many 
programs can be terminated by the use of the ESCape 
key, statement 169 is included in this program. 
The program will still be terminated by depressing 
the ESCape key, but. the active file will be closed 
and deleted before control is returned to the user. 


Statements 188 through 209 write out 51 records, 
each containing (for identification) the record 
number in addition to a string. Because no record 
numbers are specified, the records are written 
sequentially starting with record. zero. 


The user is then asked for the number of the record 
to be displayed and on line 27@ the record whose 
number is specified by the variable I is retrieved. 
Because the records which were written to this file 
each contained a 22 character string followed by an 
integer number, they must be read back into 
variables of the same type and length. 


The user is allowed to view as many records as are 
desired. Entering a negative one (-1) when asked 
for, a record number will cause the file to be 
CLOSEd and ERASEd and program execution to be 
terminated. 
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gots 


INSTRUCTIONS AND FUNCTIONS 


The following chapters describe the instruction set 
of Cromemco's 16K Extended BASIC. Although several 
of the instructions perform a variety of tasks, an 
attempt has been made to group the instructions and 
functions into logical divisions. 


Program Development Instructions encompass those 
instructions which are most frequently used by a 
programmer while developing or modifying programs. 
Documentation covers the REMark instruction and 
Assignment covers the use of the Assignment 
Operator in the LET and MAT instructions. 


The Initialization chapter describes those 
instructions which set and change the type of 
numeric representation which is used in a program 
as well as the DIMension instruction. 


Control Structures are the instructions which 
control the logical flow of a program. This 
includes conditional and unconditional transfer of 
control, loops, and program termination. 


The Input/Output chapter begins with instructions 
which may be used to transfer information to and 
from the console terminal as well as those 
instructions which are used to read DATA statements 
from the program itself. A discussion of the 
theory and use of Data Files precedes the 
definition of the various 16K BASIC instructions 
which allow the user to control and access files. 


The next chapter covers Arithmetic, Trigonometric, 
Programmer Defined, and String Functions. 


The System and File Status chapter shows the user 
how to determine and change various system statuses 
and parameters. 


Then Machine Level Instructions which allow the 
user to interact with Assembly Language subroutines 
and Fatal and Non-fatal Error Messages are 
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discussed. 


The final chapters include a Glossary of words 
which may be unfamiliar to the novice, and an 
Appendix which describes various aspects of the 


Language which may be of interest to the advanced 
user. 
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instruction: AUTOmatic Line numbering 


format: AUTOL n,m 


n is the starting line number. 


m is the line number increment. 


The AUTOL command provides automatic statement line 
numbering so that the user does not have to enter a 


line number for each line when entering a program. 

Note: 

1. The automatic generation of line numbers may 
be terminated by pressing the ESCape or 
carriage RETURN key when the user is prompted 
for the next line. 

Example: 


>>AUTOL 160,19 


>>18@ REM ALL LINE NUMBERS IN THIS 
>>1198 REM EXAMPLE ARE GENERATED BY BASIC. 
>>128 1,=5 

$ 
ERROR 1] -- SYNTAX 
>>12@ I=5 
>>13@ REM NOTICE THAT AFTER A SYNTAX ERROR 
>>148 REM AUTOL WILL RE-PROMPT SO THAT 
>>15@ REM THE ERROR CAN BE CORRECTED. 
>>16@ PRINT I 
>>17@ END 
>>18@ (carriage RETURN) 
>> 
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instruction: BYE 
format: _{Ln] BYE 


where: 
Ln is an optional number. 


The BYE instruction is used to exit from BASIC and 
return to CDOS on disk systems or MONITOR on non- 
disk systems. 

Notes: 

1. For disk systems, after the BYE command is 


typed in, the computer will respond with the 
current disk drive. 


26 For non-disk systems, BYE goes to location 
E®®8H in the MONITOR. 


3. See the Appendix, Areas of User Interest, for 
information on how to cause BYE to jump to 
another address. 


4. BYE will close all files which are OPEN at the 
time the instruction is executed. 
Example: 
>>BYE 
B. 
In this example, the user has typed the BYE 
command. The next prompt displayed (B.) indicates 


that the user is in CDOS and that B is the current 
drive. 
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instruction: 


format: 
where: 

Ln 

n 

m 


The DELETE instruction is used to remove statement 


DELETE 
{Ln] DELETE n 


{Ln] DELETE n, m 


is an optional line number. 


is the statement number of the 
first or only line to be 
DELETEd. 


is a statement number. If used, 
it indicates that lines numbered 
n through m are to be DELETEd. 


lines from the program currently in the User Area. 


Notes: 


l. The DELETE instruction must be. the last (or 
only) instruction on a line. 


2. The DELETE instruction must have at least one 


argument. 


Example: 
‘>>LIST 


19 INPUT A, 


B,C 


26 D = A+B+C 


3@ PRINT A 
48 PRINT B 
5@ PRINT C 
68 PRINT D 
70 END 


>>DELETE 398,58 


>>LIST 


18 INPUT A,B,C 
20 D = A+B4C 


6 PRINT D 
-70 END 


Here the DELETE command removes lines 38 through 59 


from the program. 
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command: DIRectory 
format: DIR 
DIR svar 


where: 
Svar is a string variable or a string 
literal file reference. 


The DIR command corresponds to the CDOS DIR commana 
(see the CDOS User's Manual for a full 
description). The DIR command lists disk files 
giving size (in K-bytes) and number of extents. If 
the optional file reference is used, it must be 
enclosed in quotation marks (string literal) or 
else must be a valid string variable. 


Examples: 


DIR will list all files on the : 
current disk. ( 
DIR "“A:*,*" will list all files on drive A. 
DIR "*.SAV" will list all files on the 
current disk with the extension 
SAV. 
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instruction: ENTER 


format: [Ln] ENTER svar 


where: 
Ln is an optional line number. 
Svar is a string variable or string 
literal file reference. 
The ENTER instruction is used to ENTER a BASIC 


program (in ASCII format) from a disk file or other 
external device into the User Area. 


Notes: 


1. 


2. 


ENTER will read a LISTed program into the User 
Area. ENTER will not read a SAVEd file. 


ENTER does not delete statement lines from the 
program which is currently in the User Area. 
ENTER does replace lines in the current 
program with. lines from the file being ENTERed 
if the line numbers are the same. 


Efficient use of memory following an overlay 
results if the ENTERed program, to as great an 
extent as is possible, replaces lines in the 
current program and does not add new line 
numbers. 


The ASCII ESCape character (1BH) is used as 
the end of file mark by BASIC. ENTER looks 
for this character to determine the end of the 
program. 
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instruction: LIST 
format: [Ln] LIST 
{Ln] LIST n 
[Ln] LIST n,m 
[Ln] LIST svar 
[Ln] LIST svar,n 
{Ln] LIST svar,n,m 


where: 
Ln is an optional line number. 


Svar is a optional string variable or 
a string literal file reference 
denoting the destination of the 
LISTing. If omitted, the 
LISTing will go to the console. 


n is the line number of the first 
line to be LISTed. If omitted, 
the entire program will be 
LISTed. 


m is the line number of the last 
line to be LISTed. If omitted, 
the program will be listed 
through the last line. 


The LIST instruction is used to LIST one or more 
statement lines from the User Area to the console, 
a disk file, or another file device in ASCII 
format. The instruction may be used to output an 
entire program, a block of statement lines within a 
program, or a single statement line. The formats 
of LIST which do not use svar will direct the 
output to the console. 


Notes: 


l. A program which has been LISTed to a disk can 
be read back into the User Area using the 
ENTER instruction. It can not be read back 
using LOAD or RUN. 


26 LISTed files are compatible between different 
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versions of Cromemco 16K Extended BASIC as 
well as different versions and sizes of the 
Cromemco Disk Operating System (CDOS). SAVEd 


files are not necessarily compatible in this 
manner, 


3. The ASCII ESCape character (1BH) is used as 
the end of file mark by BASIC. LIST outputs 
this character at the end of a program which 
is sent to the disk. 
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instruction: LOAD 


format: {Ln] LOAD svar 


where: 


Ln is an optional line number. 


svar is a string variable or string 
literal file reference. 


The LOAD instruction is used to LOAD a BASIC 
program (in internal machine format) from a disk 
file into the User Area. 


Notes: 


l. 


LOAD will read a SAVEd program into the User 
Area. The program must have been SAVEd under 
the version of BASIC and the version and size 
of the Cromemco Disk Operating System under 
which BASIC is currently being run. 


LISTed files are compatible between different 
versions of Cromemco 16K Extended BASIC as 
well as different versions and sizes of CDOS; 
SAVEd files are not. 


The LOAD instruction resets (clears) all 
variables, string variables, and matrices. 


LOAD resets the trigonometric mode to RADians. 
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instruction: RENUMBER 
format: RENUMBER 
RENUMBER m 
RENUMBER m,n 
RENUMBER m,n,b 


RENUMBER m,n,b,e 


where: 


m is the starting line number in 
the RENUMBERed program. 


n is the line number increment in 
the RENUMBERed program. 


b is the first existing line 
number to be RENUMBERed,. 


e is the last existing line number 
to be RENUMBERed. 


The RENUMBER instruction alters the statement 
numbers in the current program. 


Notes: 


Le 


The default value for the RENUMBER instruction 
is a starting line number (m) of 108 and an 
increment value (n) of 10. 


If only the first parameter (m) is specified, 
the second parameter (n) assumes the same 
value. In the example below, the command 
RENUMBER 1808 is equivalent to the command 
RENUMBER 100,100. 


The RENUMBER instruction alters line numbers 
imbedded in the entire program in GOTO, GOSUB, 
and IF-THEN statements to conform to the 
RENUMBERed statements. This will affect a 
line which is not RENUMBERed if the line 
contains a reference to a RENUMBERed line. 


RENUMBER can not normally be used to re-order 
or rearrange sections of a program relative to 
other sections. If line numbers are LISTed 
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out of order after the RENUMBER instruction is 
given, follow the procedure in the following 
note (5a-d) to rearrange the lines into 
numeric order. 


5% The RENUMBER command will include DELETED 
statement numbers in the sequence of 
renumbered statements. If this presents a 
problem (such as one or more statement numbers 
being omitted) the following procedure will 
correct the problem: 


a) LIST the program (do not SAVE it) to a 
temporary disk file. 


b) SCRatch the User Area. 


c) ENTER the temporary disk file. 


d) RENUMBER as desired. 


Examples: 
>>LIST 


11 INPUT A 
24 INPUT B 
37 PRINT A*B 
5@ GOTO 11 
63 END 


>>RENUMBER (default parameters are 19,19) 
>>LIST 


18 INPUT A 
28 INPUT B 
3@ PRINT A*B 
49 GOTO 128 
5@ END 


>>RENUMBER 108 (if n is not specified, n = m) 
>>LIST 

168 INPUT A 

280 INPUT B 

308 PRINT A*B 


498 GOTO 188 
58@ END 
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>>RENUMBER 188,19 
>>LIST 


108 INPUT A 
118 INPUT B 
128 PRINT A*B 
139 GOTO 199 
149 END 


>>RENUMBER 1800,159,129 


>>LIST 


199 INPUT A 
119 INPUT B 
18090 PRINT A*B 
1158 GOTO 169 

1388 END 


>>RENUMBER 1608,1,119,1158 


>>LIST 


188 INPUT A 
1908 INPUT B 
1081 PRINT A*B 
1982 GOTO 188 
1388 END 
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instruction: RUN 
format: [Ln] RUN 
{Ln] RUN svar 


where: 
Ln is an optional line number. 


svar is a string variable or string 
literal file reference. 


The RUN instruction instructs the computer to 
execute a program starting at the lowest numbered 
line. 


If svar is omitted, the program which is current in 
the User Area is executed. 


If svar is included, it must be the name of a SAVEd 
program. This program will be LOADed into the User 
Area and executed. 


Notes: 


Ls The RUN instruction, if given with a file 
reference, must reference a program which has 
been SAVEd under the version of BASIC and the 
version and size of the Cromemco Disk 
Operating System (CDOS) which is currently 
being used. 


LISTed files are compatible between different 
versions of Cromemco 16K Extended BASIC as 
well as different versions and sizes of CDOS; 
SAVEd files are not. 


2. The RUN instruction resets or clears all 
variables, string variables, and matrices. 


36 RUN sets the trigonometric mode to RADians. 


4. RUN resets ON ERROR and ON ESCAPE instructions 
to their default modes. This means that run- 
time non-fatal errors as well as the use of 
the ESCape key will cause a running program to 
abort and BASIC to display an error message. 


5. RUN sets the variable mode to that which was 
last specified. The default mode is Long 
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Floating Point. Refer to the Appendix, Areas 
of User Interest, if it is necessary to change 
the default mode. 
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instruction: SAVE 
format: {Ln] SAVE svar 


where: 
Ln is an optional line number. 


svar is a string variable or string 
literal file reference. 


The SAVE instruction is used to SAVE the current 
program on a disk or other file device in internal 
machine format. 


Notes: 


Le A program which has been SAVEd on a disk file 
can be read back using the LOAD or RUN 
instructions. A SAVEd program can only be 
LOADed or RUN with the same version of BASIC 
and the same version and size of CDOS it was 
SAVEd under. 
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instruction:  SCRatch 
format: [Ln] SCRatch 


where: 
Ln is an optional line number. 


The SCRatch instruction deletes the current program 
from the User Area. 


Notes: 


1. The programmer should keep in mind that the 
SCRatch command erases everything in the user 
work space and that SCRatched programs cannot 
be recovered. 


2% Once the work space has been cleared, the user 
may input a new program or access a SAVEd or 
LISTed program which has been stored on disk. 


( 3. SCRatch sets the trigonometric mode to 
MO RADians. 


4. SCRatch resets the variable mode to the 
default mode, normally the Long Floating Point 
Mode. 


5% SCRatch does not reset the ECHO or ESCape 
mode. 


6. SCRatch closes all open files before 
performing the actual SCRatch. If any file 
cannot be closed (because of disk or I/0 
problems) some other files may be left open 
and the User Area will not be SCRatched. The 
other files may be closed via the CLOSE\n\ 
instruction. 
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Example: 
>>LIST 
19 X=4 
28 INPUT Y 
36 Z=X*2+Y 


49 PRINT Z 
5@ END 


>>SCR 
>>LIST 
>> 
In the above example, all statement lines are 


deleted from memory. The user can now input a new 
program. 
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instruction: TRACE 
format: [Ln] TRACE 


where: 
Ln is an optional line number. 


The TRACE instruction sets the TRACE mode so that 
the user can follow the execution of a program line 
by line. When in the TRACE mode BASIC will list 
the line number of each statement being executed. 
Statement line numbers are listed in angle 
brackets. 


Example: 
>>LIST 


18 TRACE 

2@ INPUT X 

38 PRINT"THIS IS ";X 
49 LET Y=X+1 

5@ PRINT Y 

60 END 


eos 


>>RUN 

<20> 

2? 18 

<30> 

THIS IS 10 
<49> 

<50> 

11 

<60> 

**kKGEQ END*** 


— ; 
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instruction: No TRACE 


format: {Ln] NTRACE 


where: 
Ln is an optional line number. 
The NTRACE instruction resets the TRACE mode so 


that statement numbers are not printed during 
program execution. 
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instruction: REM 
format: {Ln] REM text 


where: 
Ln is an optional line number. 


text is any string of characters. 
The REM instruction is used to insert remarks or 
comments in a program. 
Notes: 
1. REM statements included in a BASIC program are 


ignored when the program is executed but are 
output exactly as entered when the program is 


Listed. 
2. REM statements occupy space in the User Area. 
With some long programs, or those with large 
( lists or matrices, it may be necessary to 


minimize the use of REM statements in order to 
accommodate the program. 


3. Any grammatical or typing mistakes which are 
made when inputting a REM statement will not 
generate an error message and will be output 
precisely as they appear in the statement 
line. 


4. The programmer is encouraged to use REM 
statements liberally throughout a program to 
describe program operation. These remarks can 
be particularly helpful to any one who wishes 
to use or modify a program written by another 
person. 
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instruction: LET 
format: [Ln] LET var = exp 
or 
[Ln] var = exp 


where: 
Ln is an optional line number. 


var is a numeric or string variable 
or a reference to an element of 
a matrix. 


exp is the value to be assigned to 
var. It may be any expression, 
variable, constant, function, 
string variable, or literal. 


The LET instruction is used to assign a value to a 
given numeric variable, string variable, or element 
/ of a matrix. The equal sign (=) is called the 
Ke assignment operator. Refer to section 6.2. 


Notes: 


Is BASIC is designed to allow the user to assign 
values to variables without entering LET each 
time. This capability is called implied LET. 


2. When a string variable is used with a LET 
instruction, the portion of the string which 
is referenced is set equal to null characters 
before the source is moved into the string 
variable. The whole string is referenced if 
no subscripts follow the string variable, 
while various substrings may be referenced by 
the use of subscripts. Refer to section 
5.2.3, Referencing String Variables, for a 
complete discussion of the subject. The LET 
instruction will not move more characters than 
can be accepted by the destination string or 
substring which is being referenced. 


3. In BASIC, the equal sign is also used as a 
relational operator. Refer to section 6.3. 


4. String variables or literals may only be 
assigned to string variables while any 
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expression or function yielding a numeric 
result may only be assigned to a numeric 
variable, 

5: LET and implied LET instructions execute with 
equal speed. 


Examples: 


Equivalent Implied 


LET Instructions LET Instructions 
LET A = 45 A = 45 

LET B = A + 18 B=A + 18 

LET A$ = "16K BASIC" A$ = "16K BASIC" 
GET: 73 oY ae LD ee cr: IG 

LET G = Q(19,5) G = Q(19,5) 
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instruction: MATrix 
format: MAT M = aexp 


‘where: 
aexp is an arithmetic expression, 
variable, or constant. 


The MAT instruction is used to set all elements in 
a matrix (M) equal to the value of the arithmetic 
expression (aexp). 


Notes: 
1. Matrix M must be explicitly dimensioned. 
2. This instruction is not in the instruction set 


of STAND ALONE BASIC. 


Example: 
a >>LIST 
18 DIM A(4) 
20 READ A(1),A(2),A(3),A(4) 
3@ DATA 20,21,22,23 
49 PRINT A(1),A(2),A(3),A(4) 
5@ MAT A=@ 
68 PRINT A(1),A(2),A(3),A(4) 
7@ MAT A=1 
8@ PRINT A(1),A(2),A(3) ,A(4) 
98 END 
>>RUN 
20 21 22 23 
4) Q 4) g 
1 1 1 1 


***OQG END*** 
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instruction: DEGree 
format: {Ln] DEG 


where: 
Ln is an optional line number. 


The DEG instruction sets the trigonometric 
calculation mode to DEGree. 

Note: 

1. RUN, SCRatch, and LOAD will automatically 


reset the trigonometric calculation mode to 
RADian. 
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instruction: DIM 
format: {Ln] DIM MS (aexp-1) 
[Ln] DIM M(aexp-1) 
[Ln] DIM M(aexp-1l,aexp-2) 


{Ln] DIM M(aexp-l,aexp-2,aexp-3) 


where: 
Ln is an optional line number. 
M is a numeric matrix variable. 
MS is a string variable. 


aexpl-3 are arithmetic expressions, 
variables or constants. 


The DIM instruction is used to define the size of a 

Matrix or a string variable. Cromemco BASIC 

permits the user to define one, two, or three 
dimensional matrices. 


Notes: 


1. A DIMensioned numeric matrix variable can have 
the same name as any other numeric variable. 
A DIMensioned string variable must have the 
name of a string variable. Refer to sections 
5.1.1 and 5.2.1. 


Qe If a matrix or string variable is not 
specifically dimensioned in a program, the 
default value of 18 (11 elements, numbered @ 
through 18) will be automatically assigned to 
a singly subscripted matrix or string 
variable. Doubly and triply subscripted 
matrices will generate an error message if not 
explicitly dimensioned. 


3. The maximum size of any matrix is only 
restricted by the amount of available memory. 
Any single dimension may not exceed 16382. 


4. The dimension of a string variable may not 
exceed 32766. 


PES 


5. The first element in a matrix is numbered @ 
(zero indexing). 
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instruction: IMODE 
format: {Ln] IMODE 


where: 
Ln is an optional line number. 


The IMODE instruction changes the default mode of 
all variables to the Integer mode. 


Notes: 


l. This instruction takes effect only after the 
execution of a RUN instruction after the IMODE 
instruction has been given. See the following 
example. 


2. Integer variables occupy 2 bytes and must be 
within the range +32767 to -32768. 


3. This instruction will be overridden by the 
LONG and SHORT instructions. 


Example: 
1 IMODE : X=2.5 : IF X=2.5 THEN RUN 


This line, appearing as the first line of a 
program, will ensure that the interpreter is in the 
integer mode. If the line is encountered while the 
interpreter is not in the integer mode, the IMODE 
instruction will be given, X will be set equal to 
2.5 (a non integer number), and if X=2.5 (as will 
be the case if SFMODE or LFMODE are current) the 
RUN instruction will be executed. Program 
execution will then begin over again, this time the 
RUN instruction will be given after the IMODE 
instruction and the current mode will be integer. 
When the value 2.5 is assigned to X, X will be an 
integer variable so that 2.5 will be rounded and xX 
will have the value of 3. Then X=2.5 will be false 
and control will be transferred to the next line. 
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instruction: 
format: 


where: 
Ln 


X 


INTEGER 


[Ln] INTEGER A, B(X),... 


is an optional line number. 
is a scalar variable 
is a matrix 


is an optional dimension 


The INTEGER instruction is used to declare a given 
variable as INTEGER. 


Notes: 


l. DIMensioning may be done via the INTEGER 


instruction. 


2. The INTEGER instruction must appear before the 
variable is referenced for the first time. 


3. Integer variables occupy 2 bytes and must be 
within the range +32767 to -32768. 


4. This instruction overrides the SFMODE and 
LFMODE instructions. 
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instruction: LFMODE 
format: [Ln] LFMODE 


where: 
Ln is an optional line number. 


The LFMODE instruction is used to set all variables 
within a program to the Long Floating Point mode. 


Notes: 


1. This is the standard default mode for all 
variables and arithmetic operations. 


26 This instruction takes effect only after the 
execution of a RUN instruction after the 
LFMODE instruction has been given. See the 
following example. 


3. Long Floating Point variables occupy 8 bytes 
and must be within the range +9.99E+62 to 
~ +9.99E-65. They have an accuracy of 14 
: digits. 


4. This instruction will be overridden by the 
INTEGER and SHORT instructions. 


5. See the Appendix, Areas of User Interest, if 
it is necessary to change the default mode. 


Example: 
1 LFMODE : X=9.12345678 : IF X<>@.12345678 THEN RUN 


This line, appearing as the first line of a 
program, will ensure that the interpreter is in the 
Long Floating Point mode. If the line is 
encountered while the interpreter is not in the 
Long Floating Point mode, the LFMODE instruction 
will be given, X will be set equal to @.12345678 (a 
number which cannot be represented in either Short 
Floating Point or Integer modes), and if X does not 
equal @.12345678 (as will be the case if SFMODE or 
IMODE are current) the RUN instruction will be 
— executed. Program execution will then begin over 
Reus again, this time the RUN instruction will be given 
after the LFMODE instruction and the current mode 
will be Long Floating Point. When the value 
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@.12345678 is assigned to X, X will be a Long 
Floating Point variable with the value of 
@.12345678. Then X<>@.12345678 will be false and 
control will be transferred to the next line. 
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instruction: LONG 


format: [Ln] LONG A, B(X),... 


where: 
Ln is an optional line number. 
A is a scalar variable. 
B is a matrix. 
x is an optional dimension. 
The LONG instruction is used to set a given 


variable to the Long Floating Point mode. 


Notes: 

l. DIMensioning may be done via the LONG 
instruction. 

2. The LONG instruction must appear before the 
variable is referenced for the first time. 

3. Long Floating Point variables occupy 8 bytes, 
have an accuracy of 14 digits, and must be 
within the range +9.99E+62 to +9.99E-65. 

4, This instruction overrides the IMODE and SFMODE 


instructions. 
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instruction: RADian 
format: {Ln] RAD 


where: 
Ln is an optional line number. 


The RAD instruction sets the RADian mode for 
trigonometric calculations. 
Note: 


1. SCRatch, RUN, and LOAD will automatically 
reset the trigonometric mode to RADian. 
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yes 


instruction:  SFMODE 
format: [Ln] SFMODE 


where: 
Ln is an optional line number. 


The SFMODE instruction is used to set all variables 
within a program to the Short Floating Point mode. 


Notes: 


1. This instruction takes effect only after the 
execution of a RUN instruction after the 
SFMODE instruction has been given. See the 
following example. 


2. Short Floating Point variables occupy 4 bytes, 
have an accuracy of 6 digits, and must be 
within the range +9.99E+62 to +9.99E-65. 


f 3. This instruction will be overridden by the 
LONG and INTEGER instructions. 


Example: 
1 SFMODE : X=0.90@00001 : IF X<>®@.9 THEN RUN 


This line, appearing as the first line of a 
program, will ensure that the interpreter is in the 
Short Floating Point mode. If the line is 
encountered while the interpreter is not in the 
Short Floating Point mode, the SFMODE instruction 
will be given, X will be set equal to 9.90000981 
and if X is not equal to 9.9 (as will be the case 
if IMODE or LFMODE are current) the RUN instruction 
will be executed. Program execution will then 
begin over again, this time the RUN instruction 
will have been given after the SFMODE instruction 
and the current mode will be Short Floating Point. 
When the value @.990999001 is assigned to X, X will 
be a Short Floating Point variable so that 
@.98000001 will be rounded and X will have the 
value of 90.9. Then X<>@.9 will be false and 
control will be transferred to the next line. 


121 


CROMEMCO 16K EXTENDED BASIC INSTRUCTION MANUAL 
11. Initialization Instructions 


instruction: SHORT 


format: (Ln}-SHORT Ay. BiX)4<4:< 


where: 
Ln is an optional line number. 
A is a scalar variable. 
B is a matrix. 
X is an optional dimension. 


The SHORT instruction is used to set a given 
variable to the Short Floating Point mode. 
Notes: 


1. DIMensioning may be done via the SHORT 
instruction. 


25 The SHORT instruction must appear before the a 
variable is referenced for the first time. : 


3. Short Floating Point variables occupy 4 bytes, 
have an accuracy of 6 digits, and must be 
within the range +9.99+62 to +9.99E-65. 


4. This instruction overrides the IMODE and 
LFMODE instructions. 
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The 
after a program is interrupted by a STOP statement, 
a program error, or presSing the ESCape key. 


“ye 12. Control Structure Instructions 


command: CONtinue 


format: CON 


CONtinue command CONtinues program execution 


Notes: 


l. 


fo Tory 


Program execution will commence at the line 
following the statement at which the program 
stopped. 


If program execution stopped because of a 
program error, the error can be corrected and 
the CON command used to continue execution 
from the line following the one where the. 
error occurred. 


If the user wishes to re-execute the line in 
error, GOTO (as a command) should be used. 
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Por 


statement: END 


format: Ln END 


where: 
Ln is a line number, 


The END statement halts program execution and 
causes BASIC to return to the command mode. 


Notes: 


1. Unlike the STOP statement, program execution 
may not be CONtinued after an END statement 
has been executed. 


26 Upon execution of the END statement, BASIC 
displays a message on the console indicating 
the line number of the END statement which 
caused the program to halt. 


Example: 
>>LIST 


198 PRINT "Tomorrow and tomorrow and tomorrow..." 
200 END 


>>RUN 

Tomorrow and tomorrow and tomorrow... 
KEKIGDG END*** 

>> 


: 
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instruction: FOR...NEXT 


format: [Ln] FOR avar=aexpl TO aexp2 [STEP aexp3] 


{program instructions] 


[Ln] NEXT avar 


where: 
Ln are optional line numbers. 


avar is a non-subscripted numeric 
variable. This is the index 
variable. 


aexpl-3 are arithmetic expressions, 
variables, or constants. They 
may not be string literals or 
string variables. These are the 
FOR...NEXT loop parameters. 


\ aexp-l is the initial value. 
aexp-2 is the final value. 
aexp-3 is the step value. 


The FOR...NEXT instructions are used to repeat a 
part of a BASIC program a number of times. During 
the execution of a FOR...NEXT loop, an index (X) is 
maintained. When this index becomes equal to (or 
greater than, or less than) the final value 
(aexp-3), control is transferred to the instruction 
following the NEXT instruction. 


Notes: 


1. The following sequence defines the execution 
of a FOR...NEXT loop: 


A. The expressions aexp-l, aexp-2, and aexp- 
3 are evaluated. If aexp-3 is omitted it 
is given a value of +1 (if the STEP value 
is not specified it is assumed to be +1). 


B. The index variable (avar) is set equal to. 
the initial value (aexp-l). 


~ . Cc. The instructions following the FOR and 
preceding the NEXT are executed. 
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D. The step value is added to the 
variable (avar = avar + aexp-3). 


E. If the STEP value (aexp-3) 


and the index variable (avar) 
or greater than the final value 
then the condition for termination of the 
FOR...NEXT loop has been met and control 
instruction 
following the corresponding 


is transferred to the 


instruction. 


If the STEP value (aexp-3) 


and the index variable (avar) 
or less than the final value 
then the condition for termination of the 
FOR...NEXT loop has been met and control 
instruction 
following the corresponding NEXT 


is transferred to the 


instruction. 


Otherwise execution of the loop continues 


with C above. 


2. The FOR instruction must be 
instruction on a line. It may not be followed 
by another instruction on the same line. 


3. The STEP (aexp-3) portion 


instruction is optional. If a STEP value 
not specified, BASIC assumes a value of +1 for 


aexp-3. 


4. BASIC programs will execute significantly 
faster if the loop parameter variables are 


declared as type INTEGER. 


5. FOR-NEXT loops may be nested within a program. 
It is important to keep in mind, however, that 
each FOR instruction and its corresponding 
NEXT instruction must be completely contained 


within any larger loop. 


6. Program LiSTings have FOR...NEXT loops 


indented for clarity. 
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Examples: 
>>LIST 


18 FOR A = @ TO 10 STEP 2 
26 B= Atl 

30 PRINT B; 

49 NEXT A 

50 END 


>>RUN 
1357911***5QEND*** 


In the above example, upon entering the FOR...NEXT 
loop defined by lines 18 through 48, the loop 
Parameters are evaluated and set equal to: 


@ (aexp-l, the initial value) 
18 (aexp-2, the final value) 
2 (aexp-3, the STEP value) 


The index variable is then set equal to the initial 
value (A=0). Execution continues with lines 28 and 
30 where the variable A maintains the value 
assigned to it by the FOR instruction. At line 40 
the index variable is tested to see if it is equal 
to or greater than the final value (is A > 
aexp-2?). In this case @ is not equal to or 
greater than 18, so execution continues with line 
18. The STEP value is added to the index variable 
(A = A + aexp-3). This continues until (A > aexp- 


2). Then control is transferred to statement 50. 


Correct Nesting Format: 


1@ FOR A= 1 TO 5@ STEP 2 
20 FOR B = 1 TO 3@ STEP 5 
30 FOR C = 1 TO 18 STEP l 


180 NEXT C 
118 NEXT B 
120 NEXT A 


Tllegal nesting occurs when FOR...NEXT loops 
overlap. The following example will generate a run 
time error. 
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Incorrect Nesting Format 
1@ FOR A = 1 TO 5@ STEP 2 
2@ FOR B = 1 TO 30 STEP 5 
38 FOR C = 1 TO 18 STEP 1 
196 NEXT B 
119 NEXT C 
128 NEXT A 
( 


128 


CROMEMCO 16K EXTENDED BASIC INSTRUCTION MANUAL 
es 12. Control Structure Instructions 


instruction: GOSUB...RETURN 


format: [Ln] GOSUB n 


n [program instructions] 


e 


[Ln] RETURN 


where: 
Ln are optional line numbers. 


n is the line number of the first 
statement of the subroutine to 
which control is transferred. 


The GOSUB instruction transfers control to a 
subroutine. 


When, during the execution of the subroutine, a 
RETURN instruction is executed, control is passed 

( to the instruction following the GOSUB instruction 
which called the subroutine. 


Notes: 


1. In BASIC, subroutines may be fully enclosed or 
nested in other subroutines. Subroutines may 
be nested up to 16 deep. 


When nesting subroutines, remember that the 
RETURN instruction will take you back to the 
last GOSUB and start execution of the 
instruction immediately following. Improperly 
nested GOSUB...RETURN instructions will 
generate runtime error messages. A nested 
subroutine is executed after the GOSUB 
statement and before the RETURN statement of 
the subroutine in which it is enclosed. 


26 The GOSUB and the RETURN instruction must each 
be the last instruction on a line. They may 
not be followed by another instruction on the- 
same line. 
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Example: 
>>LIST 


28 GOSUB 

3@ PRINT 

48 END 

5@ PRINT 

68 PRINT 

76 PRINT 

89 PRINT 

98 RETURN 


>>RUN 


Ic INSTRUCTION MANUAL 
tructions 


58 
“PROGRAM OVER" 


“THIS IS A SUBROUTINE" 
"WHICH DEMONSTRATES THE" 
"GOSUB STATEMENT" 


THIS IS A SUBROUTINE 


WHICH DEMONSTRATES THE 
GOSUB STATEMENT 


PROGRAM OVER 
**kKAG END*** 
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instruction: GOTO 
format: {Ln] GOTO n 


where: 
Ln is an optional line number. 


n is the line number of the 
statement to which control is 
transferred. 


The GOTO instruction unconditionally transfers 
control to the statement line specified by n. 


When used aS a statement, GOTO interrupts the 
normal execution sequence of program statements and 
transfers control to the specified statement. 


When used as a command GOTO will cause execution of 
a program to start with the specified statement. 


Notes: 


1. When used with the IF...THEN instruction, the | 
words GOTO are optional: 


IF X=8 THEN GOTO 5@ 
or 
IF X=0 THEN 5@- 


are equivalent and are both legal 
instructions. 


2. When execution of a program is initiated or 


continued using a GOTO command, no variable 
initialization takes place. 
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Example: 
>>LIST 


19 INPUT A 

26 IF A<@ THEN 260 

38 B = SQR(A) 

48 PRINT "THE SQUARE ROOT OF ";A;" IS ";B 
58 GOTO 219 

200 PRINT "THIS YIELDS AN IMAGINARY NUMBER" 
219 END 


>>RUN 

?-2 

THIS YIELDS AN: IMAGINARY NUMBER 
**k*21Q END*** 

>>RUN 

79 

THE SQUARE ROOT OF 9 IS 3 
**KKI1Q END*** 


In statement 2@ the words GOTO are omitted. This 

statement causes control to be transferred to ( 
statement 288 if the condition (A<%) is true. 
Statement 58 unconditionally transfers control to 

statement 212. 


pos 
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instruction: IF...THEN 
format-1l: [Ln] IF exp THEN n 


format—2: {Ln] IF exp THEN instruction 


[Ln] IF exp THEN instruction:instruction:... 


where: 
Ln is an optional line number. 


exp is a relational or- arithmetic 
expression, an arithmetic 
variable, or a constant. 


n is the line number of the 
statement to which control is 
transferred, 


instruction is any BASIC instruction except 
FOR, NEXT, END, REM or DATA. 


The IF...THEN instruction evaluates exp to false 
(=@) or true (not equal to @). 


If format-l is used, control is transferred to the 
specified statement if exp is evaluated as true, 
and to the next sequential statement if exp is 
false. 


If format-2 is used, and exp is true, the 
instructions remaining on the same line are 
executed before control is transferred to the next 
sequential statement. If exp is false, control 
passes to the next sequential statement line. 


Notes: 


l. In a relational expression, a relational 
operator (=, <, >=, <=, <>, or >) is used to 
compare two expressions or values. Refer to 
sections 6.3 and 6.4 for a discussion of 
relational and boolean operators. 


a No instruction may follow format-l of the 
IF...THEN instruction on the same line. 


3. Standard BASIC format must be followed for all 
instructions used with format-2. This 
includes the restriction that no instruction 
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may follow a FOR, GOTO or GOSUB instruction on 
the same line. 


4. IF...THEN instructions may be nested using 
format-2. For example: 


190 IF A = B THEN IF GS = "N" THEN 598 


is a legal statement. 


Examples: 


180 INPUT A 

118 IF A=8 THEN @"MUST BE NON-ZERO": GOTO 188 
128 PRINT A 

138 END 


In this example, the computer outputs a prompt (?) 
to which the user responds with a number. If the 
number is non-zero (A=@ is false), control will be 
passed to line 110, the number will be printed, and 
execution of the program will terminate. If the 
number is zero (A=@ is true), the part of line 180 
after THEN will be executed, printing out the 
message and returning control to line 168 which 
will request another number from the user. 


100 INPUT "First Name: ", A$ 


200 IF AS = "FRED" OR AS = "Fred" THEN GOTO 480 


388 GOTO 180 
4090 PRINT "So you are FRED!" 
588 END 


This program will continue to prompt the user with 
"First Name:" until the user responds with either 
Fred or FRED. The IF...THEN instruction includes a 
compound relational expression: 


AS = "FRED" OR AS ="Fred" 


This expression is evaluated as true (=1) if either 
FRED (all upper case) OR Fred (Upper case F, lower 
case red) is entered. This type of checking is 
very useful in interactive programs where a variety 
of user responses are to be allowed. 
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instructions: ON...GOTO 
ON. ..GOSUB 


format: [Ln] ON (aexp) GOTO nl,n2,...,ni 
[Ln] ON (aexp) GOSUB nl,n2,...,ni 


where: 
‘Ln is an optional line number 


aexp is an arithmetic expression, 
variable, or constant 


The ON...GOTO and ON...GOSUB instructions transfer 
control to any one of several lines in a program 
based on the value of the expression (aexp) 
contained in the instruction. 


Refer to the GOTO and GOSUB instructions for more 
information. 


( Notes: 


1. When aexp is evaluated, if it is equal to one, 
control will be passed to the statement 
numbered nl; if it is equal to two, control 
will be passed to the statement numbered n2; 
if it is equal to i, control will be passed to 
the statement numbered ni. 


2. If aexp evaluates to a non integer number the 
value of the number will be rounded to the 
nearest integer for the purpose of these 
instructions. 


3. If aexp is evaluated as less than one or 
greater than i the instruction will be ignored 
and control will pass to the next sequential 
instruction. 


4, If nl, n2, or ni is a nonexistant line number, 
and if control is transferred to that line, a 
fatal run time error will be generated. 


5. No instruction may follow an ON...GOTO or 
ON...GOSUB instruction on the same line. 
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statement: STOP 
format: Ln STOP 


where: 
Ln is a line number. 


The STOP statement halts program execution and 
causes BASIC to return to the command mode. 


Notes: 


l. After a program has been STOPed by a STOP 
statement execution may be restarted from the 
statement line immediately following the line 
containing the STOP statement by the use of 
the CONtinue command. . 


2. Upon execution of the STOP statement, BASIC 
displays a message on the console indicating 
the line number of the STOP statement which 
caused the program to halt. 


Example: 
>>LIST 


1@ INPUT A,B,C,D,E,F 
20 LET N=A+B/C 

30 PRINT A;B;C 

A4® STOP 

5@ PRINT D;E;F 

60 PRINT N 

70 END 


>>RUN 
?.1,2,3,4,5,6 
| 

*EKAGQ STOPE** 
>>CON 

456 

1. 6666666666667 
kKKTQ END*** 


In this example, the BASIC returns to command mode 
after encountering the STOP in statement line 4@. 
The program is then CONtinued when the user enters 
the CON command. 
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Console and DATA Input/Output Instructions 


where: 


instruction: INPUT (from the console) 
format: {Ln] INPUT X1,X2,...Xn 


[Ln] INPUT "string", X1,X2,...Xn 


Ln is an optional line number. 
X1l...Xn are numeric or string variables. 


string is an optional string literal. 
It is a prompt to be displayed 
on the console upon encountering 
the INPUT instruction. 


The INPUT instruction assigns a value, input from 


the 


console, to a variable. When the INPUT 


instruction is executed, a prompt (either a 
question mark (?) or a string as used above) is 
output to the console. The user should respond to 


this prompt by entering a list of data which 
corresponds to the variable list in the INPUT 
instruction. ; 
Notes: 

1. If the string format of the INPUT instruction 


is used, the string will replace the question 
mark as the initial prompt. 


If the user types in fewer data items than are 
called for in the variable list, a double 
question mark will appear on the terminal. 
This prompt continues to appear until each 
variable has been assigned a value. See 
examples. 


If more data is input than is required, an 
error message will be generated. 


The type of data input must be the same as the 
type of variable listed in the INPUT command. 
For example, if the INPUT command contains a 
list of numeric variables, the data input must 
be numeric data. If an attempt. is made to 
INPUT string data into a numeric variable, an 
error message will be generated. 


When a string variable is used with an INPUT 
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instruction, the portion of the string which 
is referenced is set equal to null characters 
before the source is moved into the string 
variable. The whole string is referenced if 
no subscripts follow the string variable, 
while various substrings may be referenced by 
the use of subscripts. Refer to section 
5.2.3, Referencing String Variables, for a 
complete discussion of the subject. The INPUT 
instruction will not move more characters than 
can be accepted by the destination string (or 
substring) which is being referenced. 


If the INPUT list is terminated with a 
semicolon, the carriage RETURN which the user 
types after the requested data has been 
entered will not be echoed. This allows more 
than one prompt and response sequence to 
appear on a single line. : 


Refer also to the description of the INPUT 
instruction in the chapter on Data File I/0. 


Examples: 


- >>LIST 


1 INPUT A,B,C,D 

26 PRINT A 

3 INPUT E,F 

AD PRINT B;" "sc;" "2D;" "sE;" "3F 
5@ END 


">>RUN 


? 32,18,28,4 
32 
? 190,288 


18 26 4 108 208 
**e*SQ END*** 


In the above example, the proper number of items 
was INPUT in response to each prompt. Suppose we 
were to respond to INPUT statement 198 with only 
three numbers: 
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>>RUN 

? 5,18,15 

2? 26 

5 

? 30,48 

19 15 28 30 48 
**k*GQ END*** 


BASIC displayed an additional prompt (??) when it 
did not receive as many items as were in the INPUT 
list. 


In our example, line 18 and line 3@ can be replaced 
with lines which will tell the user specifically 
what items are needed: 


>>18 INPUT "Enter four numbers: ",A,B,C,D 
>>3@ INPUT "The last two numbers? ",E,F 
>>RUN 

Enter four numbers: 100,20%0,3090,400 

18 

The last two numbers? 580,699 

208 300 408 588 680 

REKSG END*** 
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where: 


instruction: PRINT (to the console) 
format: {Ln] PRINT 


[Ln] PRINT Al,A2,...,An 


Ln . is ‘an optional line number. 


Al-n is a number, string literal 
enclosed in quotation marks, a 
numeric variable, a string 
variable, a numeric expression, 
or a standard or user defined 
function. 


The PRINT instruction is used to output information 
to the terminal. 


Notes: 
l. When used alone, the PRINT instruction will 
generate a linefeed. 
26 The at sign (@) may be used in place of the 
word PRINT for brevity. 
Example: 
3@ PRINT 
40 PRINT “AND IT SAVES SPACE" 
can also be written as: 
32 @ 
46 @ "AND IT SAVES SPACE" 
This facilitates entry of large, text-oriented 
programs with many blank lines. 
3. The spacing of output can be controlled by 


using a comma (,) or a semicolon (;) between 
items in a PRINT instruction list. 


Items separated by commas are printed 
beginning in the leftmost column of each 


_printing field. Using the default value of 29 


columns per field, the PRINT statement below: 
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1 PRINT 1,2,3,4 


will produce output in the following format: 


column 4) 20 4G 60 
no. 


See the SET instruction to change the default 
value of the number of columns per field. 


If a semicolon is used between items, the 
items are printed adjacent to each other 
(i.e., without spaces between items). For 
example, the statement: 

16 PRINT "AL"; "TO": "GE"; "TH": "RR 

> >RUN 


will produce output in the following format: 
ALTOGETHER 


Commas and semicolons may be used in a PRINT 
statement in any combination. 


If more items are listed in a PRINT statement 
than can be output on one line, BASIC will 
generate a linefeed and continue printing on 
the next line. 


More complex formatting of printed text is 
possible with the TAB and SPC functions and 
the PRINT USING instruction, 


Refer also to the description of the PRINT 
instruction in the chapter on Data File I/O. 
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Example: 
>>LIST 


18 A=1979 

28 REM B=YOUR BIRTHDATE 
38 PRINT "THIS IS ";A 
46 PRINT 

58 PRINT 

68 INPUT B 

76 C=A-B 


88 PRINT “YOU WERE BORN IN ";B 


96 PRINT 


1898 PRINT "YOU ARE "; C;" YEARS OLD THIS YEAR" 


118 END 
>>RUN 
THIS IS 1979 
? 1952 
YOU WERE BORN IN 1952 


YOU ARE 27 YEARS OLD THIS YEAR 
**k*11Q END*** 
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instruction: READ 


format: {Ln] READ Al,A2,...,An 


where: 


Ln is an optional line number. 


Al-n are numeric or string variables. 


The READ instruction is used to read values from 
DATA statement(s) and assign these values to the 


READ instruction variable list. 


Notes: 


l. The order in which variables appear 
READ instruction determines which value from 
the DATA list will be assigned to which 
variable. For instance, the first value that 
appears in the DATA list is assigned to the 


first variable in the READ list, 


the fifth 


value is assigned to the fifth variable, 


so forth. 


2 A pointer is moved in sequence through the 
list of DATA values as these values are 
assigned to variables in the READ list. 
number of DATA elements must be equal to or 
greater than the number of variables 
READ list. If there are fewer items remaining 
in the DATA list than are in the current READ 
list, an error message will be generated. 


3. DATA elements corresponding 


variables must be numeric: data and elements 
corresponding to string variables must be 


string literals. 


4. When a string variable is used with a READ 
instruction, the portion of the string which 
is referenced is set equal to null characters 


before the source is moved into 


the string 


variable. The whole string is reférenced 
no subscripts follow the string variable, 
while various substrings may be referenced by 


the use of subscripts. Refer 


5.2.3, Referencing String Variables, 
complete discussion of the subject. 
instruction will not move more characters than 
can be accepted by the destination string (or 
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substring) which is being referenced. 


Example: 

>>LIST 
1@ READ A,B,C,D$ 
20 PRINT A,B,C,D$ 
30 DATA 18,20,30,"END" 
49 END 

>>RUN 

12 20 38 END 


*k*kKAQ END*** 
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instruction: 


format: 


where: 


RESTORE 


The 
; which 


pointer 
instruction. 


instruction 


This allows the user to 


RESTORE 
[Ln] RESTORE 


[Ln] RESTORE n 


is an optional line number. 


is a line number in the current 
program. This must be a line 
number of or before a DATA 
statement. If n is not used, 
the DATA list pointer is 
positioned before the first DATA 
list item in the program. If n 
is included, the DATA list 
pointer is positioned before the 
first occurring DATA list item 
after the specified line number. 


DATA list 
the READ 
reread or 


resets the 
is associated with 


skip over DATA items. 


Example: 


>>LIST 


1@ READ A,B,C, 
20 READ E,F,G, 


30 RESTORE 

-4% READ R,S,T,U 

5®@ RESTORE 96 

6@ READ L,M,N,O 

70 DATA 1,2,3,4 

82 DATA 5,6,7,8 

98 DATA 9,10,11,12 


19@ PRINT 
118 PRINT 
1298 PRINT 
138 PRINT 


>>RUN 
1 


5 
1 
9 


KKEXPNDEF* 


ero pw 
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ra 
\ 


statement: DATA 


format: Ln DATA Al, A2,...,An 


where: 
Ln is a line number, 


Al-An are numeric expressions, 
constants, or string literals. 


The DATA statement specifies values for variables 

appearing in a READ instruction. 

Notes: 

l. The READ instruction is used to read values 
from DATA and assign these values to the READ 
instruction variable list. 

2. The RESTORE instruction allows items in the 


DATA list to be skipped or reread by resetting ; 
the DATA list pointer. ( 


Example: 
18 DATA 7*3,9+(2*1807),"This is DATA",15,75 
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instruction: PRINT USING 


format: [Ln] PRINT USING svar, Xl, X2,...,Xn 


where: 
Ln is an optional line number. 


svar is a string literal or string 
variable format definition. 


X1-n are any numeric, string or 
matrix variables, string 
literals, or constants. 


The PRINT USING instruction allows the user to 
specify a format for printing output. 


Notes: 


In examples in this section the character b 
represents a blank character. 


de A format field is bounded on either side by 
any character which is not one of the special 
characters (# & * +, $ !- .). As indicated 
in the general format for the PRINT USING 
instruction, a format expression may include 
more than one format field and may also 
include string literals. If multiple format 
fields are specified, the values of 
expressions are assigned to these fields in 
order. A format expression may also be 
assigned to a string variable. 


Example: 
>>LIST 


18 A=11 : B=333 : C=22 

2@ DIM D$ (20) : DS="###  &&&&MEEE" 
38 PRINT USING"### &&&&M&&&",A,B,C 
4@ @USING DS,A,B,C 

5@ END 


>>RUN 

11 9333M@22 
11 9333M922 
***OQG END*** 


Statement 38 in the above example outputs the 
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three variables (A, B, and C) with 2 spaces 
separating the first two and the literal M 
separating the last two. Any literal which is 
not one of the PRINT USING special characters 
may be used to separate format fields. This 
literal will be printed between the fields if 
it is a blank or any other character. 
Statement 49 outputs the same information in 
the same format using a string variable 
instead of a string literal in the PRINT USING 
instruction. Statement 48 also abbreviates 
PRINT with the symbol @. 


2. When a string literal appears in a format 
expression, the characters of the string 
literal are printed in the positions held by 
any of the special format field characters. 
Strings are left justified in the format 
field. If the number of characters in the 
string literal is less than the number of 
characters in the format field, the extra 
spaces will be blank filled. If the number of 
characters in the string literal is greater ( 
than the number of characters in the format 
field, the extra characters in the string 
literal will be truncated. 


Examples: 


In the instruction: 
PRINT USING "**** ** 4") "CTRING" 

the string literal is output in the format: 
STRINGbbb 


In the instruction: 
PRINT USING "&&&,&&&.&&" ,"STRING-LITERAL" 
the string literal is output in the format: 
STRING-LIT 


3. If the number of items in the expression list 
exceeds the number of specified format fields, 
the specified format fields will be re-used 
for the extra items. 


Examples: 


In the instruction: 

PRINT USING "$S&&.&&", A,B,C 

the expressions A, B, and C will all be 
PRINTed with the format field $S$&&.&&. 


- 
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In the instruction: 

PRINT USING "SS##bbSS$&&.&", A,B,C 

the expressions A and C will be formatted 
using the format field $$## and the expression 
B will be formatted using the format field 
SS&&.&. 


4. All normal PRINT functions (such as TAB, SPC, 


semicolon, and comma) are overridden by the 
PRINT USING instruction. 


5. The format expression may include a maximum of 
128 characters. 


6. If a number being formatted has more digits 


than allowed for in the format expression, an 
all asterisk error message will result. 


Digit Formatting 


These special characters may be used to format 


digits: 
@ # indicates leading blanks 
& indicates leading zeroes 
* indicates leading asterisks 


These symbols are used to right justify digits in a 
print field. The width of this print field is 
determined by the number of special characters 
included in a format field. Any non-digits (such 
as a minus sign) are eliminated. If the number of 
special characters in the format field exceeds the 
number of digits in the expression, the digits will 
be right justified within the field and preceded by 
characters corresponding to the special characters 
used in the format field. In the following 
examples, the character b is used to represent 
blank characters (spaces). 


Examples: 


Value of Expression Format Field Output 
1 tH tt # bbbbl 
12 HEHE bbb12 
igs 123 aT HH bb123 
Ke 1234 te Et b1234 
oo 12345 He tt # 12345 
123456 HHH kA 
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1 &&E&EE OBOG1 
12 &&EEE OBG12 
123 &&E&EE 99123 
1234 &E&EEE 81234 
12345 &&&EE 12345 
123456 &EEEE RRKKE 
1 KRKEKK KEKE] 
12 KKEKK KEKVTD 
123 KKEKKK **123 
1234 RKRKK *1234 
12345 ARK 12345 
123456 KKRKKK kKEKK 


Comma (,) 


The comma (,) places a comma in the position in 

which it appears in the format field. If the 

format specifies that a comma be output in a 

position in the field which consists of leading 

blanks, zeroes, or asterisks, then a blank, a zero, 
or an asterisk respectively are printed in the ( 
comma position. 


Examples: 


Value of Expression Format Field Output 
2983 Ht, HEH b2,883 
4 Ht , tH bbbbb4 
4457 &&&,&E 644,57 
18 &&E ,&& QBGG18 
996546 AREA 99654,6 
22 KREKK & REKED 2 


Decimal Point (.) 


The decimal point (.) places a decimal point in 
the position in which it appears in the format 
field. All digit. positions which follow the 
decimal point are filled with digits. If the 
expression contains fewer fractional digits than 
are specified, zeroes will be printed in the extra 
positions, If the expression contains more fot 4 
fractional digits than are specified, the ie 
expression will be rounded so that the number of 
fractional digits equals the number of format 
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positions available. 


Examples: 


Value of Expression Format Field Output 
234 Ht tHE 234.8008 
23.4567 HHH ETT b23.457 
13 &&.& 13.0 
66.72319 &&.& 66.7 
876.1245 PRIN om #58 76<.12 
1234567.245 KKEKK KK KKKKKKEK 


In the last example, when too many significant 
digits appear to the left of a decimal point, an 
all asterisk error message results. 


Fixed Plus (+) and Minus (-) Signs 


( The plus (+) and minus (-) signs may appear in the 

\. first character position in a format field. The 
character + or - will print the respective sign of 
an expression in the specified character position 
in the format field. When an expression is 
preceded by a plus or minus sign, any leading 
zeroes will be replaced by blanks, zeroes, or 
asterisks as specified. When a positive expression 
is preceded by a minus sign, a blank space is left 
in the sign position. 


Examples: 


Value of Expression Format Field Output 
56.8888 ttt HEH +56.889 
4.564 tHE HEH +b4.564 
6.456 +&&&.&& +986.46 
234.2 +F&EE EE +234.208 
-23.56 a kKKEK ~***I3.6 
2345 SEES or *2345.0 
-2345678. 34 —KEKKK OK RKKKKKK 
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Floating Plus (++) or Minus (--) Signs 


The use of two or more plus or minus signs at the 
beginning of a format field will output the 
respective sign directly preceding the value of the 
expression. If a positive expression is PRINTed 
USING a floating minus format, a blank is printed 
immediately preceding the number instead of a minus 
sign. The additional signs in the floating point 
format can be used to represent digits. 


Examples: 


Fixed Dollar Sign ($) 


The dollar sign 
second character position 


is used in either the first or 
in the format field to 


print out a dollar sign in that position. A dollar 
sign specified in the second position of the format 
field must be preceded by either a plus (+) or a 


minus (-) sign. 


Examples: 


Value of Expression Format Field Output 
23.456 S## tH $23.46 
4.52 SH. ## $b4.52 
-57.654 -S&E&E& GEE -$857.654 
123.7789 -S&&E GEE b$123.779 
2.34 $*.* $2.3 fc 
234.55 o*.* Fae - 
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Floating Dollar Sign ($$) 


The use of two or more dollar signs beginning at 
either the first or second character position in 
the format field will output a dollar sign 
immediately preceding the value of an expression. 
If two or more dollar signs begin in the second 
character position, the first character position 
must contain a plus or a minus sign. 


Examples: 


Value of Expression Format Field Output 
234.2345 SSSS#. ttt b$234.235 
4.45 SSSS#. HHH bbb$4.458 
23.989 SS&&.&& b$23.99 
4.5 SS&&.&& b$84.508 
24.56 =QOeES Fe bb$*24.56 
-4455.67 =o 584 t= -$4455.67 


Exponent Fields (!!!!) 


Four consecutive exclamation characters (!!!!) 
indicate an exponent in the format field. These 
four exclamation points represent the expression 
E+nn, where n is any digit. When used with a 
numeric expression, this format field will output 
the expression in exponential form. 


Examples: 


Value of Expression Format Field Output 
23.3456 HHOHEL IES 23.35E+089 
2009 HHH E LEE! 20.80E+82 
-.36 —&EE.8EI1!! -360.90E-83 


te Only the characters # or & should be used to 
the right of a decimal point. The asterisk 
(*) character follows the same rules as the # 
character when used to the right of a decimal 
point. 


ne : 8. Either the floating dollar ($$) character or 
‘e pluses (++) or minuses (--) may be used within 
the same formatting statement, but not both 
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types of characters. 

9. A non-floating print character cannot be 
placed left of a floating character. For 
example, the format fields S$+++ or +$$$ are 
legal but the format field +$++ is illegal. 

19. 16K BASIC does not check comma syntax. 


ll. Only one decimal point may be used in a format 
field. 


12. Trailing + or - signs are illegal in 
exponential format (i.e., E+nn.) 
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A typical application for the PRINT USING format 
This application is a program for 
computing a payroll on an automated basis. 


follows. 


16 
20 


ENTER 


PRINT 
PRINT 
PRINT 
INPUT 
INPUT 
INPUT 
INPUT 
PRINT 
INPUT 
PRINT 
PRINT 


"ENTER SOCIAL SECURITY NUMBER AND HOURS WORKED" 
"OF FOUR EMPLOYEES" 


A,Al 

B,Bl 

C20) 

D,D1 

"WHAT IS THE HOURLY WAGE"; 
W 


A1=Al*W : B1=B1*W : Cl=C1*W : DI1=D1*W 


PRINT 
PRINT 
PRINT 
PRINT 
PRINT 
INPUT 


USING " ########4#",A,B,C,D 
USING " SSS# see" Al Bl, Cl, D1 


"ANOTHER FOUR? TYPE 1 IF YES, TYPE @ IF NO" 
Q 


IF Q=1 THEN GOTO 19 


END 


SOCIAL SECURITY NUMBER AND HOURS WORKED 
OF FOUR EMPLOYEES 


? 552966937, 48 
? 525449121,48 
? 455238541,35 
? 211329494,32 
WHAT IS THE HOURLY WAGE? 4.68 


552966937 525449121 455238541. 211329494 


$169.96 


$168.00 $140.90 $128.90 


ANOTHER FOUR? TYPE 1 IF YES, TYPE @ IF NO 


? @ 


***21Q END*** 
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function: SPaCe 
format: SPC (aexp) 
where: 
aexp is an arithmetic expression, 
variable, or constant. 
The SPC function instructs BASIC to PRINT the 
specified number of spaces. 


Notes: 


l. The SPC function may be used only with a PRINT 
instruction. 


2. Unlike the TAB function, which always 
determines print position relative to column 
@, the SPC function determines print position 
relative to the current column location. 


Example: 
>>LIST 
18 A=2 


28 INPUT C,D 
38 PRINT SPC(1®) ;A;SPC(A*10);C;D 


48 END 
>>RUN 
? 286,308 
2 2830 
column no. 16 31 


In this example, the computer is instructed to skip 
1® spaces, print A, skip 28 spaces, and print C and 
D. 


foes, 
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function: TAB 


format: TAB (aexp) 


where: 
aexp is an arithmetic expression, 
variable, or constant. 
The TAB function causes output to begin in a 


specified column. 


Notes: 

1. The TAB function may be used only with a PRINT 
instruction. 

2. Multiple TAB functions may be included in one 
PRINT instruction, but the user should keep in 
mind that the print position indicated by 
successive TAB functions is always determined 
relative to column @. 

33 Columns are numbered @ through the page width 
so the first column is column @. 

4. If the argument to the TAB function exceeds 
the current page width, it is reduced modulo 
that page width to a number between 8 and the 
page width. The default value for the page 
width is 79. 

5. If the argument is negative, no tabbing takes 
place. 

6. If the (reduced) argument is greater than the 


current column position, a new line (CR,LF) is 
issued and the TAB is executed on the next 
line. 
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Example: 
>>LIST 


10 A=1 

20 INPUT B,C,D 

30 PRINT TAB (2);B;TAB(5) ;B+C+D; TAB (A+9) ;D 
49 END 


>>RUN 

2? 5,8,9 
5-22 9 

*KKAQ END*** 


In this example, the computer is instructed to 
begin printing B in column 2, to begin printing 
B+C+D in column 5, and to begin printing D in 
column 198. 
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DATA FILE INPUT/OUTPUT 


Data Files 


Data is information. A file is a place and method 
for storing many individual items of information. 


A computer data file (or file) is defined by: 


1. The storage medium (paper tape, floppy disk, 
etc.), 


2. The method of accessing the data (sequential 
or random), 


oe The code by which the data is translated for 
storage (ASCII or internal machine 
representation). 


Records 


A record is a group of related items. A data file 
is made up of records. Information is inserted 
into or retrieved from the file record by record. 


If a file contained information on all of the 
baseball games in one year, each record might 
contain information on one game, one player, or one 
team. All of the records would contain similar 
information. If the first record (record number @) 
held the statistics on game #1, the first number in 
the first record could be the number of hits team A 
got, while the second number would be the number of 
hits team B got. The third number could be the 
number of errors made by team A, while the fourth 
number would be the number of errors made by team 
B. The second record (record number 1) would 
contain similar information covering game #2. 
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Fields 


A field describes one item in a record. A field 
can contain string (alphabetic) or numeric 
information. 


In the above example, instead of saying that the 
first number was the number of hits team A got, we 
could say that the first field was numeric and 
contained the number of hits team A got. We can 
now further describe the record layout by saying 
that the fifth and sixth fields are alphabetic and 
contain the team names. 


Floppy Diskette 


A floppy diskette (or disk) is a flat, round 
magnetic storage medium. It is protected by a 
square envelope which exposes only a small portion 
of the surface of the disk in addition to the hole 
in the middle. When used in conjunction with a 
disk drive and disk controller, the disk becomes a 
data file storage device. Data can be added to the 
data already on the disk or records on the disk can 
be changed or deleted. 


Creating a Data File 


Before the Cromemco Disk Operating System (CDOS - 
the operating system through which all disk 
operations are performed, even if the programmer is 
using BASIC) can OPEN a disk file, it must CREATE 
the file in the file directory. 


A file can be created from the CDOS monitor by 


using the CDOS TEXT EDITOR. A file can also be 
created from BASIC by using the CREATE instruction. 
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OPENing an I/O Channel 


Once a file has been CREATEd, it must be OPENed to 
allow BASIC access to the file. The OPEN 
instruction reserves an input/output channel and 
assigns the I/0 channel number to the file 
reference or file device. Once a file has been 
opened (and assigned a channel number) all input 
and output from/to that file will be done through 
the assigned channel. 


BASIC normally carries 4 I/O channels in addition 
to the console. One I/O channel is needed for each 
file which is OPENed at the same time. Each 
channel occupies 192 bytes of memory. Increasing 
the number of channels allows more files to be 
opened simultaneously but reduces the amount of 
memory available to the BASIC user. Conversely, 
decreasing the number of I/O channels increases the 
amount of available memory. If you wish to change 
the number of channels available for use, see the 
Appendix, Changing the Number of I/O Channels. 


CLOSE 


The CLOSE instruction will disassociate the 
input/output channel number and the file which were 
associated by the OPEN instruction. The channel 
will then be available for use by other files. 


Internal Machine vs. ASCII Representation 
BASIC can store data in two formats. Both consist 
of groups of ones and zeros (binary 
representation), but each needs to be translated 
differently for output to a terminal or printer. 


ASCII (American Standard Code for Information 
Interchange) is the closest to written letters and 
numbers, ASCII is stored in the machine according 
to the table of ASCII codes (see Appendix B). Each 
character code occupies one byte (8 bits). When 
the code is translated from binary to decimal, the 
character which is represented can be found in the 
ASCII table. This is the way all BASIC strings are 
stored. ASCII information is stored so that one 
character is stored in one byte. 


161 


CROMEMCO 16K EXTENDED BASIC INSTRUCTION MANUAL 
15. Discussion - Data File Input/Output 


15.5 


The need arises for another method of storing 
numbers when speed of arithmetic computation and 
amount of storage space become important factors. 


Internal Machine code is used only for the storage 
of numbers. The number of bytes occupied by a 
number depend on its magnitude and precision (the 
size of the number and the number of decimal places 
which need to be kept). There are three internal 
machine formats: 


Integer size: 2 bytes 
range: +32767 < N < -32768 
accuracy: nearest integer 


Short Floating Point size: 4 bytes 


range: +9.99F+62 < N < +9.99E-65 


accuracy: 6 decimal digits 


Long Floating Point size: 8 bytes 


range: +9.99F+62 < N < +9.99R-65 


accuracy: 14 decimal digits 


Refer to Chapter 3 for a more complete discussion 
of internal machine representation. 


PRINT and INPUT 


PRINT and INPUT write and read in ASCII format. 
These instructions are primarily intended to write 
data to an output file which is to be printed or 
typed at a later time, and to read a data file 
which was created by the editor or another system. 
When used with a file, they exactly parallel their 
operation with the console terminal. In 
particular, file INPUT requires a comma or carriage 
RETURN between INPUT data items. 


IT IS RECOMMENDED THAT THE PUT AND GET INSTRUCTIONS 
BE USED WITH DATA FILES WHICH ARE TO BE ACCESSED BY 
BASIC PROGRAMS. 


The PRINT and INPUT instructions translate numeric 
data from ASCII to Internal Machine Format (or vice 
versa). They are therefore slower than the PUT and 
GET instructions. There is little need for the 
programmer to keep track of the type of variable 
which is written out with a PRINT instruction. An 
integer variable which is written using the PRINT 
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instruction may be INPUT back into a string or 
floating point variable without losing its meaning. 
No attempt should be made to INPUT an ASCII string 
into a numeric variable. A file which has been 
output using the PRINT instruction may also be 
TYPEd out and read whereas the same file output 
with the PUT instruction would not be able to be 
TYPEd. 


The PUT and GET instructions write and read in 
internal machine format. If an integer variable is 
written out to a file using a PUT instruction, it 
must be read back into an integer variable (and not 
into a floating point variable or an ASCII string) 
using a GET instruction or it will be meaningless. 
The machine does no translation with these 
instructions so they can be executed faster than 
PRINT and INPUT. The programmer must keep track of 
the types and lengths of variables written by PUT 
so that they may be read back in properly. 


An Interesting Note 


A string (which is stored internally in ASCII code) 
may be output with a PUT or PRINT instruction with 
the same general result (except that PRINT outputs 
a carriage RETURN-line feed sequence where 
appropriate and tabs, using spaces, when variables 
are separated by commas). This is because PUT will 
output a string in internal machine format, which 
(for a string) is ASCII. The PRINT will not 
translate the string because it is already in ASCII 
format. 
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File Pointer 


While a file is OPEN, BASIC maintains a pointer 
which may determine where the next read or write 
will occur. This pointer can be manipulated by the 
various file read and write instructions as will be 
explained in the following paragraphs. 


When a file is first OPENed, the File Pointer is 
positioned just before the first byte of the first 
record of the file. If the file is a new file 
(i.e., it contains no data), the beginning of the 
file and the end of the file coincide, and so the 
File Pointer also points to the end of file. This 
is appropriate. If a read is attempted on a new 
file, an end of file error will be returned because 
there is no data in the file. 


If no record number is specified in a file I/0 
instruction (sequential I/0), the data list 
contained in the instruction is written to or read 
from the file from the current position of the file 
pointer. 


If a record number is specified in a file I/0 
instruction (random I/0), the File Pointer is moved 
to a position just before byte zero of the 
specified record and then the data list contained 
in the instruction is written to or read from the 
file from the new position of the File Pointer. 


If a byte number is specified in addition to the 
record number, the File Pointer will be positioned 
just before the specified byte in the current or 
specified record before the I/O instruction is 
executed. 


If there is no data list associated with a PUT 
instruction, the pointer is repositioned as 
specified above and no input or output takes place. 


After the input or output has taken place, the PUT 
and GET instructions leave the File Pointer just 
after the byte which was last input or output. 


The PRINT and INPUT instruction use the Carriage 
RETURN or Carriage RETURN-Line Feed sequence as a 
delimiter. 


The PRINT instruction will move the File Pointer to 
a position just after the last PRINT character. If 
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the PRINT line starts with byte zero of the current 
record and is the same length as the specified 
record size, the pointer will be positioned just 
before byte zero of the next logical (sequential) 
record. 


The PRINT instruction will automatically insert a 
Carriage RETURN/Line Feed sequence if: 


l. the data list associated with the PRINT 
instruction will cause a record to be output 
which is longer than the page width (refer to 
the SET instruction), and 


2. no one item in the data list is not itself 
longer than the specified page width. 


This can happen when items in a PRINT list are 
separated by commas or a PRINT instruction is 
terminated with a comma or semicolon and a 
subsequent PRINT instruction adds to the already 
PRINTed line. This rule also applies to the PRINT 
instruction when used to send output to the 
console. 


A PRINT list containing an item which is longer 
than the page width will cause a run time error. 
The default page width is 8@ characters. It is 
possible to change this parameter by using the SET 
instruction. 


Sequential Files 


A sequential file is written in the order of the 
record numbers. That is, record number zero is 
written with the first output (PUT or PRINT) 
instruction, record number one is written next, 
then record number two, etc. This continues until 
the file is CLOSEd. When the file is OPENed again, 
the first record which is output will write over 
record number zero, etc. 


When a file is read sequentially, record zero is 
read first, then record one, etc. 


Note that if an entire record is not input or 
output each time the file is accessed, the File 
Pointer will remain after the last character which 
was read or written. Any subsequent file access 
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will read or write from that position, not from the 
beginning of the next record. 


Random Files 


A random access file is written in the order 
specified by the programmer. Each output 
instruction must specify the number of the record 
which is to be written. When a file is read 
randomly, the programmer must specify the record 
number to be read for each INPUT or GET 
instruction. 


A file which was written to sequentially may be 
read as a random file. Files which were written to 
randomly may be read by sequential or random 
instructions provided that no attempt is made to 
read a record before it has been written. 


A file may be accessed by any combination of 
sequential and random instructions. 


A random instruction, one that specifies a record 
or record and byte number, will reposition the File 
Pointer before accessing the file. 


A sequential instruction, one that does not specify 
a record number, will access the disk from the 
current position of the File Pointer. 


CDOS DUMP Utility 


The CDOS DUMP utility program is very useful for 
determining exactly what is being sent to a file. 
The user must exit from BASIC in order to use this 
program. Refer to the CDOS manual, Utility 
Programs — DUMP, for further information. 
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instruction: CREATE 
format: [Ln] CREATE file-ref 


where: 
Ln is an optional line number 


file-ref includes the 1 to 8 character 
file name and optionally a disk 
drive specifier and file name 
extension. 


The CREATE instruction places the file name (and 
file name extension) in the directory of the 
specified disk. A file may only be created once, 
and must be CREATEd before it can be OPENed. 


Notes: 


l. The disk drive specifier and/or the file name 
and/or the file name extension may be a string 
variable or a string literal. 


2. The file name and file name extension may 
include any printable ASCII character except 
the following: - 


$ * ? =/., 3: - “space” 


3. No space is allocated to a file by the CREATE 
instruction, All file space under CDOS is 


dynamically allocated only when and where 
needed. 


4. Error Number 137 (File Already Exists) will 
result if the file already exists in the 
directory when the CREATE instruction is 
given. 
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instruction: OPEN 
format: [Ln] OPEN\n\ file-ref 
{Ln] OPEN\n,pl\ file-ref 


[Ln] OPEN\n,pl,p2\ file-ref 


where: 
Ln is an optional line number 
n is the required file (channel) 
number. 
pl (for a disk file) is the 


optional record size in bytes 
which may be assigned any value 
between 1 and 32,767. The 
default value is 128 bytes per 
record (one sector). 


p2 (for a disk file) is the 
optional file access mode. 
specifier: 


=l is read only 

=2 is write only 

=3 is read and write 
(default value) 


file-ref includes the 1 to 8 character 
file name and optionally a disk 
drive specifier and file name 
extension. 


The OPEN instruction allows a disk file or system 
device to be linked to a file number (channel) for 
future reference in connection with file 
input/output instructions (i.e., PUT, GET, INPUT, 
PRINT, CLOSE). 


Notes; 


1. The disk drive specifier and/or the file name 
and/or the file name extension may be a string 
variable or a string literal. 


2. The file name and file name extension may 
include any printable ASCII character except 
the following: 
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$* 2? =/.y, 3: - “space" 


3. The file number must be between 1 and the 
maximum channel number available. As disk 
BASIC is shipped, the maximum channel number 
is 4, See the Appendix for the method of 
changing the number of channels available, 


4. Error number 133 (File Number) will result if 
an attempt is made to reference a file number 
greater than the maximum channel number 
available. 


ae The file number @ (zero) is reserved for the 
console. It cannot be OPENed by the user. 
All Input/Output (GET, INPUT, PUT, and PRINT) 
directed from/to file @ will use the console. 


Caution, if file number @ is specified by the 
CLOSE instruction, all currently OPENed files 
will be CLOSEd. 


\ 6. Although files OPENed for read/write access 
may be used as write only files, slightly 
faster execution speed may result if the file 
is OPENed for write only access. 


7. If the PRINT instruction is used to write a 
Single item which is longer than the current 
page width, it will be necessary to increase 
the page width (using the SET instruction) in 
order to avoid Error number 6 (PRINT ITEM 
SIZE). Refer to the discussion section of 
this chapter for additional information. 
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instruction: CLOSE 
format: {Ln] CLOSE 
[Ln] CLOSE \n\ 


where: 
Ln is an optional line number 


n is an optional file (channel) 
number. The default value is 
ALL currently OPENed files. 


The CLOSE instruction disassociates the channel 
number and file which were associated by the OPEN 
instruction, 


Note: 
If the CLOSE instruction is given with the file 


number set equal to @ (zero), all currently OPENed 
files will be CLOSED. 
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instruction: 


format: 


where: 
Ln 


pl 


p2 


expl-n 


— When used without a 


Instructions - Data File Input/Output 


PRINT 
{Ln] PRINT 


[Ln] PRINT exp-1,...,exp-n 


[Ln] PRINT\n\ 


[Ln] PRINT\n,pl\ 


[Ln] PRINT\n,pl,p2\ 


[Ln] PRINT\n\ exp-1l,...,exp-—n 


[Ln] PRINT\n,pl\ exp,...,exp-n 


[Ln] 


is an optional line number 


is an optional file number. If 
no file number is specified, or 
if the file number is zero, 
output goes to the console 
terminal. 


(for a disk file) is the 
optional record number. The 
default value is sequential 
access starting with record @. 


(for a disk file) is 
optional byte number. 
default value is byte @. 


the 
The 


is an optional list of numeric 
or string expressions, numeric 
or string variables, or string 
literals. The data list must be 
separated by either semicolons 
or commas. If an item is 
followed by a comma, the item 
following it will be printed 
starting in the next tab 
position; if it is followed by a 
semicolon no space will be left 
before printing the next item. 

the PRINT 


file reference, 


instruction will cause the data list to be output 
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to the console. When used with a file reference, 
it will cause the data list to be output to an 
ASCII device (e.g., the line printer) or a disk 
file in ASCII format. 


Notes: 


IT IS RECOMMENDED THAT PRINT ONLY BE USED FOR THE 
OUTPUT OF PRINT OR LIST FILES AND NOT BE USED FOR 
WRITING DATA FILES WHICH ARE TO BE READ BACK BY A 
BASIC PROGRAM. 


Ls The at (@) sign may be used to abbreviate the 
word PRINT in this instruction. 


26 Most of the above forms of the PRINT 
instruction may incorporate the PRINT USING 
feature. Refer to PRINT USING for additional 
information. 


3. The PRINT instruction outputs a carriage 
return-line feed (@D, OA hex) sequence at the 
end of the data list. If the file is to be 
read in using the INPUT instruction, a CR-LF 
sequence (or just a CR) must follow each item 
which is output, as it is this character or 
character sequence which delimits (terminates) 
each item. In BASIC, there are two ways this 
can be accomplished: 


a. Allow only one item per PRINT 
instruction. 


b. Insert a CR between each item as follows: 


168 AS = CHRS$ (13) 
200 PRINT \1\ "STRING"; AS; Nl; AS; QS 


Statement 188 assigns the hexadecimal value of 
the CR to the string variable A$. Statement 
20@ PRINTS a string literal, a numeric 
variable, and a string variable, each 
separated by the CR. 


The above procedure will allow all of the 
items output by the PRINT instruction to be 


read by the INPUT instruction which looks for 
a CR between each item read. 


If only numeric data is to be PRINTed and 
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INPUT a comma (ASCII 44) may be used as a 
delimiter between variables within one INPUT 
list. The last item in the data list must be 


delimited by a CR. 


4, Specifying a negative number for either pl or 
p2 will result in the default value being 


assigned to that parameter. 


5. The PRINT instruction, when given without a 
data list, causes one blank line to be sent to 


the console or a PRINT file. 
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instruction: INPUT 
format: {Ln] INPUT var-1l,...,var-n 
(Ln] INPUT\n\ var-l,...,;var-n 
[Ln] INPUT\n,pl\ var,...,var-n 
[Ln] INPUT\n,pl,p2\ var-l,...,var-n 


where: 
Ln is an optional line number 


n is an optional file number. If 
no file number is specified, or 
if the file number is zero, 
input is received from the 
console terminal. 


pl (for a disk file) is the 
optional record number. The 
default value is sequential 
access starting with record @. " 


p2 (for a disk file) is the 
optional byte number. The 
default value is byte @. 


varl-n is a list of one or more numeric 
or string variables. 


When used without a file reference, the INPUT 
instruction will cause the data list to be INPUT 
from the console. When used with a file reference, 
it will cause the list to be INPUT from an ASCII 
device (e.g., paper tape reader) or a disk file in 
ASCII format. 


Notes; 


1. When a string variable is used with an INPUT 
instruction, the portion of the string which 
is referenced is set equal to null characters 
before the source is moved into the string 
variable. The whole string is referenced if 
no subscripts follow the string variable, 
while various substrings may be referenced by / 
the use of subscripts. Refer to section abe 
5.2.3, Referencing String Variables, for a ~ 
complete discussion of the subject. The INPUT 
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instruction will not move more characters than 
can be accepted by the destination string or 
substring which is being referenced. 


INPUT can accept no more than 132 characters 
per line. 


INPUT retrieves only 7 bit ASCII. The GET 
instruction must be used to retrieve all 8 
bits. 


INPUT treats Some control characters as 
editing or end of file commands. 
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instruction: PUT 
format: [Ln] PUT\n\ 
[Ln] PUT\n\ exp-1,...,exp-n 
[Ln] PUT\n,pl\ exp,...,exp-n 
[Ln] PUT\n,pl,p2\ exp-1l,...,exp-n 
where: 
Ln is an optional line number 
n is a file number. If file 
number @ is used, output will be 
set to the console. 
pl (for a disk file) is the 
optional record number. The 
default value is sequential 
access starting with record @. 
p2 (for a disk file) is the { 
optional byte number. The ° 
default value is- byte @. 
expl-n is an optional list of numeric 
or string expressions, numeric 
or string variables, or string 
literals, 
The PUT instruction outPUTs the data in the data 
list (exp-l,...exp-n) to the file specified by the 
file number (n). The data is output in internal 
machine format. This is useful if the data is to 
be read back by BASIC. The PRINT instruction 
should be used if the file is to be TYPEd or listed 
to the printer. 
Notes: 
1. If no outPUT list is included, only the device 
status is set (i.e., record and byte position 
on a disk file). This is a useful way of 
setting status (position) without actually 
initiating any data transfer. 
, : ( 
2. The PUT instruction will output data to a file Ree. 


in internal machine format (see notes at the 
beginning of this chapter on Internal Machine 
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vs. ASCII Representation). Numeric data which 
has been output using the PUT instruction 


must be read back in using the GET 
instruction. 


ASCII data which is output by the PUT 
instruction will not be readable by INPUT 
unless a CR appears at least every 132 bytes. 
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instruction: GET 
format: [Ln] GET\n\ exp-l,...,exp-n 
{Ln] GET\n,pl\ exp,...,exp-n 
[Ln] GET\n,pl,p2\ exp-l,...,exp-n 


where: 
Ln is an optional line number 


n is a file number. If file 
number @ is used, input will be 
accepted from the console. 


pl (for a disk file) is the 
optional record number. The 
default value is sequential 
access starting with record @. 


p2 (for a disk file) is the 
optional byte number. The 
default value is byte @. ( 


expl=n is an optional list of numeric 
or string expressions, numeric 
or string variables, or string 
literals. 


The GET instruction GETs the data in the data list 
(exp-l,...exp-n) from the file specified by the 
file number (n). The data is input without 
translation (internal machine format). This is 
useful if the data has been outPUT by the PUT 
instruction. 


Notes: 


l. When a string variable is used with a GET 
instruction, the portion of the string which 
is referenced is set equal to null characters 
before the source is moved into the string 
variable. The whole string is referenced if 
no subscripts follow the string variable, 
while various substrings may be referenced by 
the use of subscripts. Refer to section 
5.2.3, Referencing String Variables, for a 
complete discussion of the subject. The GET fC a 
instruction will not move more characters than Re 
can be accepted by the destination string or 
substring which is being referenced. 
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PROGRAMMED FUNCTIONS 


Cromemco 16K Extended BASIC includes a number of 
arithmetic and trigonometric functions which 
perform common, frequently used calculations. 
These functions are pre-defined in BASIC so that 
the programmer does not need to write a program 
everytime one of these functions is required. 


Cromemco BASIC also includes a number of functions 
designed to increase string handling capabilities, 
a number of system functions which provide general 
system information, and a function which makes it 
possible to call assembly language subroutines. 


In addition to these pre-defined functions, 
Cromemco BASIC permits the programmer to define up 
to 26 additional functions. 


Cromemco 16K BASIC includes the following 
functions: 


Arithmetic Functions 


ABS (X) absolute value of X 

BINAND (X,Y) binary logical AND 

BINOR (X,Y) binary logical OR 

BINXOR (X,Y) binary logical EXCLUSIVE OR 

EXP (X) the value "e" to the power X 
FRA (X) the fractional portion of X 

INT (X) integer value of X 

IRN (X) generates an integer random 


number between @ and 32767 
LOG (X) natural logarithm of X 
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Functions 


MAX (X1,.-,Xn) 


MIN 


RANDOMIZE 


RND 


SGN 


SOR 


(X1l,.,Xn) 


(X) 


(X) 
(X) 


INSTRUCTION MANUAL 


returns the numeric expression 
Xn with the maximum value in 
the expression list 


returns the numeric expression 
Xn with the minimum value in 
the expression list 

used with RND and IRN to 


produce different sets of 
random numbers 


generates a random number 
between @ and 1 


algebraic sign of X 


square root of X 


Trigonometric Functions 


ATN 


COs 


SIN 


TAN 


(X) 
(X) 
(X) 
(X) 


arctangent of X 
cosine of X 
sine of X 


tangent of X 


Programmer Defined Functions 


DEF FNs (Xl,...,Xn) = Y 


String Functions 


ASC (X$) 


CHRS 


(X) 


allows the user to define up to 
26 different functions 


provides equivalent ASCII 
numeric value of the first 
character of X$ 


gives a single character string 


which is the ASCII equivalent 
of X 


186 


a 


CROMEMCO 16K EXTENDED BASIC INSTRUCTION MANUAL 


16. 


Functions 


LEN (X$) 


POS (X$,Y$,n) 


STRS (X) 


VAL (XS) 


Descriptions and 


returns the length of string 
Xs. 


determines the location of a 
substring (Y$) within a string 
(X$) by returning the value of 
the position at which the first 
character of the substring is 
located starting with character 
Ne 


converts any numeric expression 
X to a string which is the 
character representation of X. 


converts any string expression 


x $ to the numeric 
representation of X$. 


examples of each of these 


functions are included in the following section. 


Also see Chapters 17 and 18 for descriptions of 
additional functions. 
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function: ABSolute value 
format: ABS (aexp) 


where: 


aexp is an arithmetic expression, 
variable, or constant. 


The ABS function gives the absolute (i.e., 
positive) value of xX, which can be any numeric 
expression. 


Example: 
>>LIST 
1@ PRINT ARS (-26), ABS (2S) 
28 END 
>>RUN 
26 26 


*k*KOG END*** 
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functions: BINAND 
BINOR 
BINXOR 
format:  BINAND(aexp-1l,aexp-2) 
BINOR (aexp-1,aexp-2) 
BINXOR (aexp-1,aexp-2) 


where: 
aexpl-2 are arithmetic expressions, 
variables, or constants. 


The BINAND, BINOR, BINXOR functions perform logical 
operations bit by bit on 16-bit operands. 


BINAND performs a BINary AND logical operation on 
aexp-l and aexp-2. It returns a 1 bit in a given 
position if both bits are equal to 1 and a @ 
otherwise. 


BINOR performs a BINary OR logical operation on 
aexp-l and aexp-2. It returns a 1 bit in a given 
position if either bit is equal to 1 and a @ 
otherwise. 


BINXOR performs a BINary exclusive OR logical 
operation on aexp-l and aexp-2. It returns al bit 
in a given position if either bit is equal to 1 and 
the other bit is equal to @. A @ is returned 
otherwise. 


Notes: 


1. If necessary, aexp-l and/or aexp-2 will be 
converted to 16 bit integers for the purpose 
of these functions, 


2. Refer to section 6.4 for a discussion of 
boolean operators. 
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function: EXPonent 
format: EXP (aexp) 


where: 
aexp is an arithmetic expression, 
variable or constant. 


The EXP function calculates the value of the 
constant e (where e = 2.71828...) raised to the 
aexpth power. 


Example: 
>>LIST 


18 A=4,.1 

20 B=EXP(A) 
38 PRINT B 
49 END 


>>RUN 


68.348287597344 
*KKAQ END*** 
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function: FRActional portion 
format: FRA (aexp) 
where: 
aexp is an arithmetic expression, 
variable or constant. 
The FRA function returns the fractional portion of 
aexp. 
Example: 
>>LIST 
10 B=3.7 


28 PRINT FRA(B) 
38 END 


>>RUN 
0.7 
***3Q END*** 
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function: INTeger portion 
format: INT (aexp) 


where: 
aexp is an arithmetic expression, 
variable or constant. 


The INT function returns the largest integer value 
which is less than or equal to aexp. 


Examples: 
>>LIST 


108 A=5.7 
200 PRINT INT(A) 
302 END 


>>RUN 

5 

***39Q END*** 
>>PRINT INT (-5.7) 
-6 
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ETON 


function: Integer Random Number generator 
format: IRN (X) 


where: 
X is a dummy argument. 


The IRN function generates an integer random number 
between @ and +32767. 


Note: 


1. To change the sequence of random numbers, the 
RANDOMIZE instruction should be included in 
the program. 


Example: 
>>LIST 


18 FOR N=1 TO 18 
28 PRINT IRN (6) 
386 NEXT N 

49 END 


>>RUN 
29284 
25801 
18835 
4647 
9295 
18846 
4924 
18185 
26216 
7652 
*kkKKAQ END*** 


The program listed above will print out 18 integer 
random numbers. If this program is run a second 
time, it will generate the same 18 random numbers. 
A different set of random numbers will be generated 
only if a RANDOMIZE statement is included at the 
beginning of the program. 
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function: LOGarithm 
format: LOG (aexp) 
where: 
aexp is an arithmetic expression, 
variable or constant. 
The LOG function calculates the natural logarithm 
(i.e., log to the base e) of aexp. 


Note: 


1. The logarithm base 19 for aexp can be computed 
as follows: 


log base 1@(aexp) = LOG (aexp) / LOG (19) 


Example: 
>>LIST 


1@ INPUT A 
28 B=LOG (A) 
38 PRINT B 
49 END 


>>RUN 

e se2 
1.1631588898056 
*kKKAQ END*** 
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function: MAXimum value 
format: MAX (aexp-l,...,aexp-n) 


where: 
aexpl-n are arithmetic expressions, 
variables, or constants. 


The MAX function examines the list of arithmetic 
expressions (aexp-l through aexp-n) and returns the 
value of the largest expression. 


Example: 
>>LIST 


18 X=10 

28 Y=25 

38 M=MAX (X,Y) 
48 PRINT M 

5@ END 


***59 END*** 
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function: MINimum value 
format: MIN (aexp-1,...,aexp-n) 


where: 
aexpl-n are arithmetic expressions, 
variables, or constants. 


The MIN function examines the list of arithmetic 
expressions (aexp-l through aexp-n) and returns the 
value of the smallest expression. 


Example: 

>>LIST 
18 X=5 
28 Y=19 
38 M=MIN (X,Y) 
48 PRINT M 
5@ END 

>>RUN 

5 


KEES G END*** 
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instruction: RANDOMIZE 
format: [Ln] RANDOMIZE 


where: 
Ln is an optional line number. 


The RANDOMIZE instruction is used to reset the > 
random number dummy variable used by the RND and 
IRN functions so that a different sequence of 
random numbers will be produced each time the RND 
and IRN functions are used. 


Notes: 


1. RANDOMIZE should be used only once within a 
program utilizing RND to ensure that a truly 
random sequence of numbers results. 


2. RANDOMIZE shold be used after generating every 
1808 numbers using IRN. This will ensure a 
( truly random sequence of numbers. 


Example: 
>>LIST 


1@ PRINT "THIS IS A RANDOM NUMBER "; 
28 RANDOMIZE 

38 PRINT RND (@) 

49 END 


>>RUN 

THIS IS A RANDOM NUMBER @.7137712225 
*kKKAQ END*** 

>>RUN 

THIS IS A RANDOM NUMBER @.81719789825 
*kKAQ END*** 


This program will print a different random number 
everytime the program is RUN. 
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function: RaNDom number generator 
format: RND (X) 


where: 
x is a dummy argument. 


The RND function generates a random number in the 
range ® < RND(®) <1. 


Examples: 
>>LIST 


19 FOR N=1 TO 198 
28 PRINT RND(2) 
38 NEXT N 

48 END 


The above example will print out 188 random 

numbers. If this program is run a second time, it 

will generate the same 188 random numbers. To 
generate a new set of random numbers each time the 

program is run, the above example can be rewritten 

as follows: 


>>LIST 


1@ RANDOMIZE 

2@ FOR N=1 TO 1868 
38 PRINT RND(2) 
40 NEXT N 

5@ END 
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function: SiGN 
format: SGN (aexp) 
where: 
aexp is an arithmetic expression, 
variable or constant. 
The SGN function returns a +l if the value of the 


expression aexp is greater than @, a @ if aexp 
equals @, and a -1 if aexp is less than @. 


Example: 
>>LIST 
1@ INPUT A,B,C 
28 PRINT SGN (A) 
39 PRINT SGN (B) 


48 PRINT SGN(C) 
58 END 


***SQ END*** 
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function: SQuaRe root 
format: SOR (aexp) 
where: 
aexp is an arithmetic expression, 
variable or constant. 
The SOR function calculates the square root of any 
positive expression. 


Example: 


>>PRINT SOQR(9) 
3 
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function: ArcTaNgent 
format: ATN (aexp) 
where: 
aexp is an arithmetic expression, 
variable or constant. 
The ATN function calculates the arctangent of 
aexp. 
Note: 
l. Although 16K BASIC does not include predefined 


ARCSIN and ARCCOS functions, the user can 
calculate these using the ATN function as 


follows: 

ARCSIN (X) = ATN (X/SOR (-X¥*X+1) ) 

ARCCOS (X) = -ATN (X/SOR (-X*X+1))+2. *ATN (1.) 
Example: 

>>PRINT ATN(.8@) 

@.67474094222353 


In this example the arctangent of .8@ is equal to 
-67478094222353 radians. If the DEGree mode is 
selected, the arctangent of .8@ is given in 
degrees: 


>>DEG 


>>PRINT ATN(.88) 
38.659888254987 
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function: cCOSine 
format: COS (aexp) 
where: 
aexp is an arithmetic expression, 


variable or constant. 


The COS function calculates the cosine of the angle 
represented by aexp. 


Notes: 

1. See ATN for a description of how to calculate 

, ARCCOS. 

2. Unless DEG mode has been selected, it is 
assumed that the value of aexp is expressed in 
RADians. 

Example: 
>>LIST 

1@ INPUT A 
20 LET B=A*2 
38 PRINT COS (B) 
49 END 
>>RUN 
2? 68 


8.36235775447529 
***AQ END*** 


In this example, the cosine of a 1.20 radian angle 
is .36235775447529. 
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ie 
function: SINe 
format: SIN (aexp) 
where: 
aexp is an arithmetic expression, 
variable or constant, 

The SIN function calculates the sine of an angle 

represented by aexp. 

Notes: 

Li See ATN for a description of how to calculate 
ARCSIN. 

2. It is assumed that the value of aexp is 
expressed in RADians unless the DEG mode has 
been specified. 

Examples: 

) >>LIST 
| 
\ 
18 INPUT A 
20 PRINT SIN(A*3) 
38 END 
>>RUN 
? G4 
@.11971229728892 
kEKIQ END*** 

In this example, the sine of a .12 radian angle is 

approximately .12. 

In the following example, we first select the DEG 

mode and then request the program to print the sine 

of a 98 degree angle: 
>>LIST 
5 DEG 
18 PRINT SIN(9@) 
28 END 
>>RUN 
2 1 
if *KEOQ END*¥** 
Ke 


The sine of a 98 degree angle is 1.9. 
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function: TANgent 
format: TAN (aexp) 
where: 
aexp is an arithmetic expression, 
variable or constant. 

The TAN function calculates the tangent of the 

angle represented by aexp. 

Note: 

1. It is assumed that the value of aexp is 
expressed in RADians unless the DEGree mode 
has been specified. 

Example: 
>>LIST 

5 DEG 
18 PRINT TAN (38) 
29 END 
>>RUN 


9.577350269189 
***29 END*** 
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function: Programmer Defined 


format: DEF FNs (avar-l,avar-2,...,avar-—n) =aexp 


where: 


s is any single ASCII character 


(A-Z). 


avarl-n are arithmetic variables. 


aexp is an arithmetic 


The DEF function permits the programmer to define 
up to 26 functions in addition to the pre-defined 


functions included in BASIC. 


Notes: 


1. The definition of a function must be a 
statement which is encountered during the 
execution of a program in order for BASIC to 
retain the definition. After the function has 

in a command 


been defined, it may be used 
line. 


26 Any of the variables used in the definition of 
a function (avar-1l through avar-n) 
to the function. Their use in the definition 
does not conflict with a variable of the same 
name appearing elsewhere in the program. 


If a variable appears on the right side of the 
definition without appearing on the left, 
is a global variable and maintains its value 


through a function call. 
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Programmer Defined Functions 


Examples: 


>>LIST 


10 X=20 

20 Y=10 
38 Z=5 

4® DEF FNR(A,B,C)=A*B+C 

5@ PRINT FNR (X,Y,Z) 

60 END 


>>RUN 
205 
***KGQ END*** 


In the above example, variables X, Y, and Z are 
global variables while A, B, and C are local to the 
definition of the function, 


The following example should help to clear up any 
confusion between local and global variables. 


>>LIST 
1868 DEF FNZ (P) = P * D 
200 P = 77 
3806 D=5 
408 E = 18 


509 PRINT FNZ (E) 
69@ PRINT P 
708 END 


>>RUN 

58 

77 

***E70Q END*** 


In the above example, statement 188 defines the 
function FNZ in terms of the formal parameter 
(function definition variable) P and the program 
variable D. In statement 198 P is called a 
function definition variable because it appears to 
the left of the equal sign in the function 
definition. As such, P can not be accessed by the 
user. The program variable (P) defined by 
statement 208 is a different variable than the 
aforementioned function definition variable, and 
can be accessed by the user. According to the 
above definitions, D, appearing in statement 1986, 
is a program variable. In statements 398, 409, and 
598 program variables P, D, and E are assigned 
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Programmer Defined Functions 


values. 


In statement 588, the value of the function FNZ is 
computed using the value of E to replace P in the 
definition of the function. Being a program 
variable, D maintains its value in the calculation 
of the value of the function. Once the value of 
the function has been calculated, its value is 
printed. 


Statement 698 prints the value of the program 
variable P to demonstrate that the program variable 
P can be accessed by the user, that it maintains 
its value through the function call, and that it is 
a different variable than the function definition 
variable P. 
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function: ASCii value of a character 
format: ASC (Svar) 


where: 
svar is a string variable or literal. 


The ASC function gives the ASCII decimal value of 
the first character of any string expression. 
Note: 
1. See the Appendix for a table of ASCII 
characters and their values. 
Example: 
>>LIST 
18 INPUT x$ 


2@ PRINT ASC (XS$) 
38 END 


***39 END*** 


In this example, the ASCII decimal value for the 
first character of the string variable x$ 
(character A) is 65. 
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function: CHaRacter 


format: CHRS (aexpr) 


where: 


aexpr is an arithmetic expression, 
variable, or constant. 


The CHRS function returns the single character 
which is represented in ASCII by aexpr. 


Notes: 


aie 


If aexpr is outside of the range @<aexpr<255 
an error will be generated. 


2. This function allows the user to draw graphs 
or figures with special characters. The 
function may also be used to initiate special 
functions such as cursor positioning, 
generating line or form feeds, or causing a 
bell to sound on the terminal. 
3. This function may be used to output non- 
printing and special purpose characters such 
as control or underline characters. 
Example: 
>>LIST 
19 INPUT X 
28 PRINT CHRS (X) 
38 END 

>>RUN 

? 42 


* 
*kkKK3ZQ END*** 


The ASCII decimal value 42 is equivalent to the 
character *,. Thus, in the above example, the 
instruction PRINT CHRS (42) instructs the computer 
to output the character * on the terminal. 
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function: LENgth of string 
format: LEN (Svar) 


where: 
Svar is a string variable or literal. 


The LEN function returns an integer value which is 
equal to the number of characters in any string 


variable XS. In other words, the LEN function 
gives the length of a string. 


Note: 

1, Both characters and spaces are counted as part 
of the length. Trailing null characters are 
not counted as part of the string length. 

Example: 
>>LIST 


1@ DIM X$ (26) ,Y$ (30) 
20 INPUT X$,YS$ 


38 @"THERE ARE "; LEN(X$); “™ CHARACTERS IN Xx$" 
49 @"THERE ARE "; LEN(Y$); " CHARACTERS IN ys" 
50 END 

>>RUN 

? EXAMPLE 


?? LENGTH COMMAND 

THERE ARE 7 CHARACTERS IN Xx$ 
THERE ARE 14 CHARACTERS IN yY$ 
***5Q END*** 
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function: POSition 


format: POS (svar-l,svar-2,,aexp) 


where: 
svar-l is a string variable or literal 
Svar-2 is a substring variable or 
literal 
aexp is an arithmetic expression, 


variable, or constant 


The POS function is used to locate the position 
within a string (X$) of the substring (Y$). The 
position within the string X$ at which the search 
is to begin is specified by the arithmetic 
expression aexp. This function gives a value equal 
to the position of the first character of the 
substring within the string. 


ie 


Notes: 

l. A -l is returned if the substring is not 
found. 

2. Remember that the first element of a string is 


numbered @. 


Example: 

>>LIST 
18 DIM X$ (58) 
28 XS="THIS IS A SUBSTRING SEARCH" 
39 P=POS (X$,"1IS",4) 
48 R=POS (X$,"R",28) 
5@ PRINT P 
68 PRINT R 
78 END 

>>RUN 

5 

23 


*K*ET7Q EBND*** 


Ko 


In this example, the computer is first instructed 
to search for "IS" starting from the fourth 
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character in X$ and second to search for "R" 
starting from the twentieth character in xX$. 
Starting from position 4, the first character in 
substring "IS" is located in position 5. Starting 
from position 2@, the first character "R" is 
located in position 23. Consequently, the computer 
returns a value of 5 for P and 23 for R. 


A very useful application of this function is the 
conversion of numbers from hexadecimal to decimal. 
The following program demonstrates the principle 
uSing a one digit number: 


>>LIST 


1980 DIM AS(@) 

119@ INPUT "One digit hex number: ",AS 
1206 D = POS ("@123456789ABCDEF", AS, @) 
1306 IF D = -1 THEN GOTO 1100 

149@ PRINT "The decimal equivalent is: ";D 
15698 GOTO 1199 

1608 END 
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function: STRing 
format: STRS (aexp) 
where: 


aexp is an arithmetic expression, 
variable, or constant. 


The STR$ function converts aexp to a string which 
is the ASCII representation of the expression. 
Note: 

i. Valid input to this function include the 
decimal point (.) and a leading plus (+) or 
minus (-) sign. 

Example: 
>>LIST 

2 19 INPUT A 
28 AS=STRS (A) 
38 PRINT A$ 
49 END 
>>RUN 
? 8.45 


8.45 
***EAQ END*** 
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sf 
function: VALue 
format: VAL (Svar) 
where: 
svar is a string variable or literal. 
The VAL function converts a string (svar) into a 
numeric variable which may be used in arithmetic 
expressions. 
Notes: 
4. If the argument string for VAL consists of 
both numeric and non-numeric information, the 
following conventions hold: 
a. If the first character is non-numeric, 
VAL will return a zero value (this can be 
an extremely useful way of decoding a 
user's input). The first character is 
considered to be numeric if it is the 
leading percent sign (%) of a legal 
hexadecimal constant. 
b. If the first character or characters are 
numeric they will be converted without 
consideration of the portion of the 
string after the first non-numeric 
character. 
Example: 
>>LIST 
19 X$="26.6321" 
28 A=1 
30 B=A+VAL (X$) 
4@ PRINT B 
5@ END 
>>RUN 
27.6321 
kEKSQG BND*** 
\ 
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command: DiSK 


format: DSK 
DSK “yu 


where: 


Xx is a disk drive specifier (l, 2, 
3, 4, A, B, C, or D) or the at 
Sign or zero (@ or @). 


The DSK instruction displays or alters the current 
system default disk drive. 


Notes: 


l. 


When used without a disk drive specifier, DSK 
displays the current disk drive identifier. 


While a program is RUNning, DSK will not 
display anything. Use IOSTAT (6,8) to 
determine the current drive while in the RUN 
mode. 


When used with a disk drive specifier, DSK 
changes the current system default disk drive. 
The following is a list of equivalent disk 
drive specifiers: 


or 
or 
or 
: or 


YdaAW > 
mW 


The above specifiers may be enclosed in 
quotation marks (string literal) or assigned 
to a string variable. 


New disks are not logged in by changing the 
default disk drive. See the following note 
for the method of logging in a new disk from 
BASIC. 


When used with the at sign or zero (@ or @), 
DSK logs in a new disk (after it has been 
inserted in any drive) and causes drive A to 
become the current system default disk drive. 
The effect of this is similar to typing CTRL-C 
while in CDOS. 
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instruction: ECHO 
format: [Ln] ECHO 


where: 
Ln is an optional line number. 


The ECHO instruction is used to re-enable the 
display of certain information at the console 
terminal after the display has been disabled by the 
NOECHO instruction. 
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instruction: NO ECHO 
format: {Ln] NOECHO 


where: 
Ln is an optional line number. 


The NOECHO instruction is used to disable the 


display of user entered responses to the INPUT 
instruction. 


Notes: 


l. This instruction is useful when a secret code 
or password is to be INPUT. The code will not 
be displayed on the screen, making theft of 
the code almost impossible. 


2. The NO ECHO mode is NOT reset by the RUN or 
SCRatch instructions. 
Example: 
>>LIST 
18@ NOECHO 


200 INPUT X 
309 PRINT X 


400 END 
>>RUN 
? (user entered INPUT is not 
displayed) 
517 (the value of X is PRINTed by the 


PRINT statement) 
***AGQ END*** 
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instruction: ERASE 
format: {Ln] ERASE svar 


where: 
Ln is an optional line number. 


svar is a string literal or string 
variable file reference. 


The ERASE instruction will remove a file from the 
file directory. 


Examples: 


ERASE "TEMP.BAS" 
ERASE -"*.BAK" 
ERASE "B:TEMP.REL" 


The first of these examples will ERASE the file 
named TEMP.BAS from the current or default disk 
drive. The second will ERASE all files from the 
current disk drive with the file name extension of 
BAK. The third example will erase the file called 
TEMP.REL from the disk in the B drive. 
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instruction: ESCape 


format: [Ln] ESC 


where: 
Ln is an optional line number. 
The ESC instruction is used to re-enable ESCape key 


operation after it has been disabled by the NOESC 
instruction. 
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instruction: NOESCape 
format: {Ln] NOESC 


where: 
Ln is an optional line number. 


The NOESCape instruction disables the console 
terminal escape key operation. 


Notes: 


1. Most terminal keyboards include a key labeled 
ESC. BASIC recognizes the ESCape character as 
a signal to abort program execution and return 
to the command mode. The NOESC instruction is 
used to prevent program interruption when the 
ESC key is pressed. 


2. ESCape results from the use of the CTRL-Z, 
ESC, or CTRL-[ key. 
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function: FREe space 


format: FRE (X) 


where: 


Xx is a dummy argument, 


The FRE function gives the number of bytes of 
memory in the User Area which are currently free or 
unused. 


Notes: 


Le 


ee 


Certain statements do not occupy their full 
space until after they have been executed 
(e.g., DIM). 


Because BASIC allocates space for its internal 
tables in segments, the FRE function is only 
an approximation of the actual number of bytes 
available to. the user. 


Space recovered from DELETEd lines is 
available for new program lines, not for 
arrays or variables. Thus, the FRE function 
will not necessarily reflect available program 
Space, 


If statement lines have been DELETEd from the 
User Area, it will be necessary to perform the 
following procedure in order for the FRE 
function to reflect the change: 


a) LIST the program (do not SAVE it) to a 
temporary disk file. 


b) SCRatch the User Area. 
c) ENTER the temporary disk file. 


d) Type PRINT FRE(X). 
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function: 


IOSTATus 


format: [Ln] IOSTAT (aexpr-1l, aexpr-2) 
where: 

Ln is an optional line number. 

aexpr-l is a file (channel) number. 

aexpr-2 is the status parameter. 


The IOSTAT function returns the current status of 


an opened BASIC file. 


Status Returned 
Parameter Value Meaning 

4) g File is ok. 

1 End of File. 

2 Attempt to read an unwritten 
segment during a random 
access read. 

1 xX X is the current sector 
number. (This is not the 
record number.) 

2 Y Y is the current byte number 
within sector X (above). 

Notes: 
1. Devices other than disk drives may or may not 


return status values. 


26 IOSTAT (@,@) 
number. 


will 
Disk A=l, 


return the current disk 
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instruction: ON ERROR 
format: {Ln] ON ERROR STOP 
[Ln] ON ERROR GOTO nl 
[Ln] ON ERROR GOSUB nl 


where: 
Ln is an optional line number. 


nl is the line number of the 
statement to which control is 
transferred. 


The ON ERROR instruction causes program control to 
be transferred as specified (STOP, GOTO, or GOSUB) 
when a non-fatal error occurs during program 
execution. 


Notes: 


ce A non-fatal error in BASIC is any error listed 
in the error table (see Appendix A) with a 
number of 128 or greater. Errors numbered 127 
and below are defined as fatal errors and 
cannot be trapped with an ON ERROR statement. 


26 If ON ERROR is written at the beginning of a 
program, the instruction specified with ON 
ERROR will be executed each time a program 
error occurs. If placed elsewhere in the 
program, the statement will be executed only 
for errors which occur during the execution of 
statements following the execution of the ON 
ERROR statement. 


3. ON ERROR is reset by RUN and SCRatch 
instructions. 


217 


CROMEMCO 16K EXTENDED BASIC INSTRUCTION MANUAL 
System and File Status Instructions & Functions 


ITs 


Example: 


69 

8B 
199 
128 
146 
169 
388 
320 


INPUT A,B 

PRINT A*B 

ON ERROR GOTO 388 

INPUT C,D 

PRINT C/D 

GOTO 698 

PRINT "A non-fatal error has occurred" 
GOTO 12@ 


In this example, any error which occurs before line 
198 has been executed for the first time will be 
dealt with by the standard system error handling 


procedure. 


Any trappable error which occurs after 


line 198 has been executed will cause program 
execution to continue with statement line 300. 
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instruction: ON ESCape 
format: {Ln] ON ESC STOP 
[Ln] ON ESC GOTO nl 
{Ln] ON ESC GOSUB nl 


where: 


Ln is an optional line number. 


nl is the line number 
statement to which control 


transferred. 


The ON ESC instruction causes program control to be 
or GOSUB) 
when the ESCape key is depressed during program 


transferred as specified (STOP, GOTO, 


execution. 


Notes: 


l. If ON ESC is written at the beginning of a 
program, the instruction specified with ON ESC 
will be executed each time the ESCape key is 
depressed. If placed elsewhere 
program, the statement will be executed only 
when the ESCape key is depressed following the 


execution of the ON ESC statement. 


2. ON ESC is reset by RUN and 
instructions. 
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/ 
\ 
Example: 
>>LIST 
18 INPUT A,B,C 
15 IF A = -1 THEN 62 
26 LET D=A+B+C 
38 ON ESC GOTO 198 
49 PRINT D 
58 GOTO 528 
68 END 
>>RUN 
? 18,15,2@ 
45 (escape must be pressed here to 
get out of the loop statement 
58.) 
? 76,18,5 
85 
? -1,0,@ 
**EXEQ END*** 
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instruction: 


format: 


where: 
Ln 


Svar-l 


svar 


RENAME 


[Ln] RENAME svar-l, svar-2 


is an optional line number. 


is a string literal or string 
variable file reference to the 
existing file. 


is a string literal or string 
variable file reference to the 
new file. 


The RENAME instruction is used to give a new file 
name to a file already in the file directory. 


Example: 


RENAME "OLDFILE", "“NEWFILE" 


This command will change the name of the file (on 
the current disk drive) from OLDFILE to NEWFILE. 
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instruction: SET system parameter 
format: SET aexp-l, aexp-2 


where: 


aexpl-2 are arithmetic expressions, 


variables, or constants. 


aexp-l is the system parameter 


number. 


aexp-2 is the value 


assigned to 


parameter. 


The SET instruction is used to change the value of 


a given system parameter. 


Notes: 


Pe Refer to the SYS instruction for a list of all 


user accessible system parameters. 


2% System parameter number 9 is the width of a 
page in characters and may assume any value 
between @ and 32767. The default value for 
this parameter is 8@ characters 
corresponds to a standard 8 1/2 inch page. 


A special use of the set command is: 


SET ®, -l 


which inhibits the automatic carriage RETURN- 
line feed at the end of a line when page width 
is reached. Refer to the discussion of the 


PRINT instruction as it pertains 
output. 


Using SET @,-1 to disable page width checking 
is especially useful for graphics output to 
devices such as the Cromemco 3355 printer. 


3. System parameter 1 is the tab field width and 
may assume any value between 1 and 32767. 
This corresponds to the width of the field 
which is output by a comma (,) in a PRINT 
instruction. If the tab field width is set to 
a ® or -1, no tabbing takes place 
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commas are treated as semicolons). 
default value for this parameter 

characters. This default value may be 
changed, see the Appendix, Areas 


Interest. 


4. For disk BASIC only, a System parameter has 


been added to facilitate timed 


Start the timer, the SET 5 instruction 
given, with aexp-2 equal to approximately ten 
(18) times the number of seconds of delay 
desired. Halve aexp-2 if using a 2MHz clock. 


For example: 


SET 5,50 


will allow about 5 seconds for a complete user 


response. 


When the next INPUT instruction 
encountered, BASIC will issue an ERROR 216 -- 
INPUT TIMEOUT if the user does not 
with a complete input within the allotted 


time. 


Once set, the time used to respond to all 


subsequent INPUT instructions 


together until it excedes the specified value, 
and then an error message is generated. 


therefore necessary to give 


instruction prior to each timed INPUT. 
it may be 


timed INPUT is no longer desired, 
de-activated by coding: 


SET 5,6 


The ON ERROR statement can be used to trap the 
timeout error. The programmer may find out 
how much time was used by coding SsyYS(5) 


find the time remaining. 
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function: SYStem 
format: SYS (aexp) 


where: 
aexp is an arithmetic expression, 
variable, or constant. 


The SYS function provides system information based 
on the value of the argument aexp. 

Notes: 

Ls See the SET instruction for methods of 


changing the default values of these system 
parameters. 


Argument 
Value System Parameter Returned 

4) page width (number of 
characters) 

1 tab field width (number of 
characters) 

2 character last printed (i.e., 
current character) 

3 last runtime error number (for 
disk BASIC) 
last runtime error two-letter 
ASCII code (for stand-alone 
BASIC) 

4 current print column number 

5 current input timer value 
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Example: 


188 ON ERROR GOTO 798 


149 OPEN \1l\ "TESTFILE.DAT" 


709 IF SYS(3)=128 THEN CREATE"TESTFILE. DAT" 


In this example, if the file TESTFILE.DAT did not 
originally exist on the disk, the error handler at 
line 788 would CREATE the file. Lines 712, 
etc. could be written to test for other values of 


SYS (3), and take appropriate action(s). 
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instruction: INPut 
format: INP (m) 


where: 
m is an I/O port. 


The INP instruction is used to read the contents of 
INPut port (m). 


Note: 


1. The value of m must be in the range @<m<255. 


Example: 


1@ NOESC : INTEGER K 
20 IF BINAND(INP(@) ,%894603) 
38 K INP (1) 
K BINAND (K, 3007F3%) 
60 IF K = $891B% THEN PRINT : GOTO 180 
76 PRINT CHRS (K); 
80 IF K = 13 THEN PRINT 
98 GOTO 26 
1098 ESC 
119 END 


®@ THEN GOTO 26 


When a character is typed at the console, this 
program will echo it back to the console CRT. A 
carriage RETURN will be echoed as a carriage RETURN 
followed by a line feed, and an ESCape will 
terminate the program. 


The NO ESCape instruction at line 18 is necessary 
to disable BASIC's continuous polling of input port 
QO. While a program is being executed, basic 
ignores most characters typed at the console. 
BASIC continually polls the UART status port @ and 
if a character is ready, reads it from port l. If 
this character is not an ESCape character, it is 
ignored by BASIC. If it is an ESCape character, 
program execution is terminated. 


Upon reading the UART status, the status bit is 
reset. It is necessary to disable BASIC's polling 
of the status port so that this user program will 
be able to determine if a character has been typed. 
If this were not done, BASIC would, by reading the 
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status port, reset the character ready bit, thereby 
preventing the user program from determining that a 
character had been typed. 


Line 6% replaces the ESCape key function by testing 
the character typed by the user. If it is an 
ESCape, program execution is terminated. 


Statement 26 is a loop which continually polls the 
UART status ready port to determine if a character 
has been typed. The Receiver Data Available flag 
is bit 6 (refer to the 4FDC manual). The contents 
of input port 8 is ANDed with 48 hex to determine 
if this bit is a one or a zero. If it is a zero, 
no data is available, and control remains on line 
29, polling the input port again. 


If the bit has been set (=1) it indicates that data 
is available, and statement 39 reads the data from 
input port 1 and assigns this data to the variable 
K. Line 48 strips the parity bit off of the input 
data (the ASCII character set requires only the 
seven bits, ® through 6) and as stated before, line 
6@ terminates program execution upon determining 
that an ESCape character (1B hex) has been input. 


The rest of the program prints the ASCII character 
whose value was input, outputs a line feed if a 
carriage RETURN was input, and transfers control to 
line 290. 


When an ESCape is detected, control is transferred 


to line 1088 which re-enables the operation of the 
ESCape key and terminates program execution. 
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instruction: OUTput 
format: OUT m, b 


where: 
m is an I/O port 


b is a byte value 
The OUT instruction is used to OUTput data byte (b) 
to OUTput port (m). 
Notes: 
1. The value of m must be in the range #<m<255. 


2. The value of b must be in the range O<b<255.. 


Example: 


>>OUT 1,75 


will display the character xK (ASCII 75) on the 
console terminal (OUTput port 1). 


229 


CROMEMCO 16K EXTENDED BASIC INSTRUCTION MANUAL 
18. Machine Level Instructions 


instruction: PEEK 
format: PEEK (m) 


where: 
m is a memory location. 


The PEEK instruction returns the contents of memory 

location (m). 

Note: 

is If m is decimal, it must be in the range: 
®<m<32767. Hexadecimal numbers may be used to 
access locations in the range: O<h<8FFFFS%. 

Example: 


PRINT PEEK (5) 


will print the contents of memory location 5. 
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instruction: POKE 
format: POKE m,b 


where: . 
m is a memory location. 


b is a byte value. 
The POKE instruction puts the byte value (b) into 
memory location m. 
Notes: 
1. If m is decimal, it must be in the range: 
®<m<32767. Hexadecimal numbers may be used to 


access locations in the range: O<h<$FFFFS%. 


2. The value of b must be in the range @<b<255. 


Example: 
POKE 1608,255 


will place the value 255 into memory location 1990. 
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function: USeR program 
format: USR (m,Pl,...,Pn) 
where: 
m is the address of the assembly 


language routine. 


Pl-n are parameters which are 
converted to 16 bit integers. 


The USR function makes it possible to call an 
assembly language subroutine from a BASIC program. 


Notes: 


1. The USR function always requires the user to 
specify one parameter in addition to the 
address, even if it is a dummy parameter. For 
example, USR(@,1) is correct, while USR(®@) 
will result in a syntax error. 


2. If m is decimal, it must be in the range: 
®<m<32767. Hexadecimal numbers may be used to 
access locations in the range: O<h<%FFFFS%. 


3. USR is a function and must take the form of a 
function when it is used: 


>>1808 A = USR (X,Y) 


4. When the user routine gains control (at the 


address specified in the USR function call), 
the following conventions apply: 


a) Register A contains the number (n) of 
parameters in the function call. 


b) Register pair HL contains the return 
address to BASIC. The user routine may 
re-enter BASIC by coding the following 
assembly language instruction: 


JP (HL) 
c) The parameters were placed in order 
(i.e., Pl was PUSHed first, followed by 


P2, P3,...-, Pn) on the CPU stack and may 
be recovered via POP instructions. 
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d) If and only if n parameters (n is the 
contents of register A, as above) are 
POPped off the stack, and the stack 
pointer is not otherwise changed, BASIC 
may be re-entered via the following 


instruction: 
RET 


e) The routine may return a 16-bit value to 
be assigned to the function by placing 
the value in DE register pair before re— 
entering BASIC. 


f) Aside from the restrictions noted above, 
all registers may be used in any way by 
the user routine. 


Example: 


The following routine, when POKEd into position by 
the BASIC program starting at line 1898, will allow 
the BASIC user to perform CDOS system calls. The 
USR function must be used to access this routine, 
The first parameter of the USR function is the 
starting address of the assembly language routine 
(in this case, 193 Hex). The second and third 
parameters are the values which are to be loaded 
into the DE and BC register pairs before the system 
call. Upon returning from the routine, the entire 
USR function takes on the value of the A register. 
This value may be accessed by assigning the USR 
function to a variable. Notice that the Cc portion 
of the BC register pair always contains the CDOS 
system call number. 
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REM DATA statements 198 & 118 are the machine 
REM code equivalent of the following assembly 
REM language routine: 
REM 
REM pop de 
REM pop bc 
REM call 5 
REM ld d,@ 
REM ld e,a 
REM ret 
REM 
DATA $00D1%,%089C1%,%89CD%,39005%, 20080 
DATA $8016%,%0000%,%005F%,%00C9% 

INTEGER A,I 

FOR I = %@103% TO %9190B% 

READ A 

POKE I,A 

NEXT I 
REM 
REM Following BASIC program demonstrates 
REM the CDOS system call which positions the 
REM CRT cursor. 
REM 

SET @,-1 : REM disable page width checking. 
REM clear screen and home cursor. 
A = USR(%8103%,0,142) 

FOR I = 1 TO 24 

GOSUB 4489 

NEXT I 

REM 

REM Clear and home cursor. 
A = USR(%8103%,8,142) 

FOR I=24 TO 1 STEP -1l 

GOSUB 4469 

NEXT I 
GOTO 16998 

REM 
REM 
REM subroutine to compute diagonal column 
REM given a row number, position cursor 
REM at the given location, and print the 
REM index number there. 
J = I1*3 : REM compute column number 
REM Move column number into high byte 
REM and row number into low byte 
K = 256*J+I 
A = USR(%0103%,K,142) 

PRINT I; 
RETURN 

END 


234 


CROMEMCO 16K EXTENDED BASIC INSTRUCTION MANUAL 
19. Glossary 


GLOSSARY 


[ ] 


Square brackets are used to indicate an optional 
quantity. The item enclosed in square brackets may 
be used, in the position indicated, at the user's 
discretion. 


Arg ument 


An argument is an independent variable, constant, 
or expression used with a BASIC instruction whose 
value can be specified by the user to instruct 
BASIC to perform a certain task. For example, in 
the instruction: 


PRINT A, 3, C+7 


A, 3, and C+7 are arguments to the BASIC 
instruction PRINT. 


ASCII 


This acronym stands for American Standards Code for 
Information Interchange. It is an industry 
Standard used to assign numerical codes (@ through 
127) to 128 characters used as letters, numbers, 
arithmetic operators, various symbols, and control 
characters. The ASC(X) function will return the 
ASCII equivalent of any argument. A table of ASCII 
codes is provided for reference in the Appendix. 
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BASIC Word 


A BASIC word, commonly called an instruction, is an 
alphanumeric set of characters which briefly 
describes the operation to be performed by the 
computer. Some examples of BASIC words are: 


LIST 
PRINT 
ON ERR 
LEN 
STOP 
RND 


Binary Code 


Binary code is defined as a code where every code 
element is either a @ or a _l. Computer 
instructions and data for most microcomputers 
consist of unique, 8 bit binary codes. 


Command 


A command in BASIC is an instruction to the 
computer which specifies an operation to be 
performed. In contrast to a BASIC statement (see 
the STATEMENT definition), commands are executed 
immediately. Commands are used primarily to 
Manipulate or execute a program once the program 
has been entered. Commands have no line number 
preceding them. 


A powerful feature of Cromemco 16K BASIC is the 
ability to use most commands as statements. As 
such, they may be given line numbers and included 
in the body of the program for execution while the 
program is running. 
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Control Character 


A control character is a non-printing ASCII 
character which is (usually) used to transmit 
control signals between a peripheral device and the 
computer. For example, a CTRL-P entered from the 
console will cause the system printer to echo all 
information which is displayed on the console. 


Current Program 


The current program is any program with which the 
user is currently interacting. When 16K BASIC is 
entered, no program is current. Should the user 
enter text to create a new program, this program 
becomes the current program. If the user calls a 
Saved program from system memory, that program 
becomes the current program. If the user edits a 
Program, it remains the current program in its 
edited form. 


Data 


The term is used in two wayS. Strictly speaking, 
any information contained within memory or control 
logic: is binary data. Whether this data becomes 
alphanumeric characters or control information 
depends upon the program in use. 


In the other sense, data is used to refer to 
numerical or string information. In BASIC, this 
numerical or string information is listed in a file 
or DATA statement. 


Default 


With certain BASIC instructions, an argument may be 
optionally added to control a certain function. If 
no argument is given, the instruction defaults or 
reverts to a value already programmed into the 
BASIC interpreter. For example, the default values 
of the arguments for the command: 


RENUMBER 
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are 198,18 in Cromemco BASIC. This default value 
for RENUMBER will produce automatic line 
renumbering starting with line 198 and numbering 
consecutive lines by increments of 16, (e.g., 19, 
20, 30, 48...). To change this default value, the 
BASIC word must be followed by an argument. For 
example, the command: 


RENUMBER 5,5 


will provide automatic line renumbering starting 
with line 5 and continuing by increments of 5 
(esGiag Se 105 2Se30) 


Disk Storage 


A disk is a computer memory device which is used to 
store information. Disks are typically used in 
place of main memory when large amounts of 
information must be stored. A disk is similar in 
appearance to a phonograph record. Most 
microcomputer systems currently offer disk storage 
capabilities through either large or mini floppy 
disks. The floppy and mini floppy terms refer to 
the two different sizes (8 inch and 5 inch 
respectively) of the flexible plastic disks used 
with the disk assemblies. 


Expression 


An expression is defined as any combination of 
variables, constants and operators which is 
evaluated as a single value or logical condition. 
For instance, in the statement: 


19 LET A = (B*C) + (A*D) 
the (B*C) + (A*D) operation, the value of which is 
assigned to variable A, is interpreted as an 
expression. In the statement: 


1@ IF A = B THEN GOTO 258 


the logical comparison A = B is called an fk 
expression and is evaluated to True (=1) or False A 
(=). . 
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File or Data File 


A File defines a group of related information. 
This information is addressed by means of a File 
Reference and usually resides on a floppy diskette. 


File Name 


This is a one to eight character label which is 
used to refer to a File. Several Files may have 
the same File Name. These Files may be uniquely 
identified by the use of a Disk Specifier and/or a 
File Name Extension. 


Firmware 


Firmware is the middle ground between hardware and 
software, This term is generally applied to 
specific software instructions that have been 
burned in or programmed into Read Only Memory 
(ROM). 


Floating Point Mode 


Floating point mode refers to a method of computer 
calculation in which the computer keeps track of 
the decimal point in each number. In 16K BASIC, 
three formats are used to define variables: 
Integer, Long Floating Point, and Short Floating 
Point. In the Long Floating Point mode, numerical 
values are allowed up to 14 digits. In the Short 
Floating Point mode, numerical values are limited 
to 6 digits. The default value in Cromemco BASIC 
is the Long Floating Point (LFP) mode. 
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Hardware 


In comparison to firmware and software, hardware 
represents the actual metal (or hard) elements of a 
computer system. Items such as printers, 
terminals, and the computer itself are considered 
to be hardware. 


Integer 


An integer is defined as a whole numbeY, positive 
or negative. The following numbers are examples of 
integers and non-integers: 


INTEGERS NON-INTEGERS 


3 3.14159 
1 - 66666 
-5 2/3 


Integer Mode 


Integer mode is a format used to define variables 
in which one or all variables within a given 
program are set to integer values only. 


Interactive 


An interactive device is one used to achieve direct 
person to computer communication, and vice versa. 
The teletype and CRT terminals are the best known 
examples of interactive terminals, although many 
variations are possible, 
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I/O (Input/Output) 


The I/O initials stand for Input and Output. I/o 
is the transfer of data between the computer system 
and an external device. Devices such as CRT 
(Cathode Ray Tube) terminals, TTY (teletypewriter) 
terminals, and disk drives are examples of devices 
that accept the input data from the user, another 
peripheral device, or from the computer memory, and 
that output data to the computer. 


Line Number 


All lines in BASIC begin with a line or statement 
number. For example: 


19 PRINT A, B 


includes the statement number 18. Line numbers can 
‘be assigned manually or through the AUTOL command 
and may be any integer from 1 through 99999, All 
BASIC lines have a unique number which is used to 
access lines which require modification or deletion 
from the program. 


Matrix 


A matrix is an array of numeric variables in a 
prescribed form. For example, the array: 


2 2°. 8 
1 4 6 
30 4&5 


is a matrix with three rows and three columns. A 
matrix with m rows and n columns is written: 


all al2 al3 ...aln 


a21 a22 a23 ...a2n 


aml am2 am3 ...amn 
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The individual entries in the matrix are called 
elements or cells. For example the quantity aij in 
the above matrix is the element in row i and column 
j- Subscripts used to indicate elements always 
denote the row first and the column second. 
Cromemco BASIC permits the user to define one, two, 
or three dimensional matrices. A two (i.e., Mij) 
or three (i.e., Mijk) dimensional matrix is 
commonly called a table. A one dimensional matrix, 
a matrix with n columns but only one row, is 
commonly called a list. For example, the matrix: 


is a list (or a matrix) with one row and four 
columns. 


Memory 


The computer memory is used to store information, 
including programs and data, for future use. 
Microcomputers typically use semiconductor 
memories, of which the two most common types are 
random-access memory (RAM) and read-only memory 
(ROM). From a hardware perspective, memory 
consists of an array of bistable, individually 
addressable elements each of which represents a 
single binary digit. Information can be_ stored 
either in main memory, which commonly consists of 
RAM or ROM, or external storage devices, which 
include disks, magnetic tape, and magnetic drums. 


Peripheral Device 


Peripheral devices are units which are used in 
conjunction with a computer but which are external 
to the computer. Peripherals refer to devices such 
as printers, plotters, terminals, disk storage 
devices, etc., which can be connected to the 
computer. The computer is assumed to be the 
central unit and peripherals are merely support 
devices. 
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Program 


A computer program is a set of instructions 
arranged into statement lines. The instructions 
are used to instruct the computer to perform 
specified operations in a certain order. Programs 
are designed and written to solve a wide range of 
problems and are used in applications as varied as 
process control, data reduction, telephone systems, 
mathematical analysis, games, and stock market 
transactions. 


PROM 


This acronym stands for Programmable Read Only 
Memory. PROMs consist of an array of memory cells 
that can be fixed in certain patterns by the 
application of higher than normal voltages. These 
memories are said to be non-volatile; that is, when 
power is withdrawn the programmed pattern remains. 


« Recently, EPROMs, or Erasable PROMs, have appeared 
and have found industry wide usage. EPROMs may be 
erased by exposure to ultraviolet light, and then 
re-programmed,. The Cromemco Bytesaver II is 

designed to program EPROMs. 


Protocol 


Protocol is a set of conventions on the format and 
content of messages to be exchanged between two 
logical devices. Most often, differences in timing 
account for failure of devices to communicate. For 
example, a certain signal might, of necessity, be 
Present to enable an I/0 request to a 
microprocessor's protocol. To match a computer to 
a terminal, one must know the mutual handshake 
protocol, 
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RAM 


RAM stands for Random Access Memory, or read-write 
memory. In contrast to PROMs, read-write memory 
can be changed as well as being read. Some RAMs 
(known as dynamic) retain data for only a fraction 
of a second and must be refreshed constantly to 
retain data. All RAM is volatile and must have 
power applied to retain data patterns. 


ROM 


A ROM is a Read Only Memory device that is used for 
storing fixed information. This information is 
burned in, or programmed, at specific locations 
when the ROM is manufactured. A ROM cannot be 
written into during operation. Any ROM that can 
later be altered is a Programmable Read Only Memory 
{see PROM). ROM family memories, once burned, 
retain their data regardless of power 
contingencies, 


Sector 


A Sector is a subdivision of a track. A track ona 
large disk is divided into 26 sectors while a small 
disk track is divided into 18 sectors. Sectors are 
numbered starting from number one and each sector 
holds one record or 128 (89H) bytes. 


Software 


Software is a term used to refer to the programs, 
languages and procedures used in a computer. For 
example, the 16K BASIC interpreter as well as any 
BASIC programs are identified as software. 
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Statement or Statement Line 


A statement in BASIC is an instruction or series of 
instructions to the computer. A statement is 
defined as one line in a BASIC program which is 
preceded by a line number. For example: 

198 A = BC 


is defined as a statement. Typically, a statement 
can contain a maximum of 132 characters. 


A powerful feature of Cromemco 16K BASIC is the 
ability to use most statements as commands. As 
such, they may be used without line numbers and 
executed immediately. This is very useful for 
debugging programs. 

Cromemco 16K BASIC also allows more than one 


instruction on a single statement line as long as 
adjacent instructions are separated by a colon (:). 


String Literal 
A string literal (or string) is a sequence of 
alphanumeric characters, spaces, and special 
characters. In 16K BASIC, string literals must be 
enclosed within quotation marks. Examples of valid 
string literals include: 

"CROMEMCO 16K BASIC" 

"12345" 

"THIS PROGRAM PRINTS SQUARE ROOTS" 
The statement: 

1@@ PRINT "CROMEMCO 16K BASIC" 
will output the string 


CROMEMCO 16K BASIC 
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String Variable 


A string variable is a variable which may assume 
the value of a string literal. 


Track 


A Track is a physically defined circular path which 
is concentric with the hole in the center of a 
disk. It is defined by its distance from the 
center of the disk. With the read/write head of 
the disk drive located on a given track, data may 
be read from or written to that track. A large 
disk has 77 tracks, while a small disk has 4@. 


User Area 
The User Area is the BASIC workspace in which a 


program can be written, edited, and run. The LIST ( 
command displays the contents of the User Area. 


Variable 
A variable is a quantity that can assume any one of 
a given set of values. In 16K BASIC, variables are 
defined by a single letter (A through Z) or a 
Single letter followed by one digit (@ through 9). 
Examples of legal variable names include: 

A 

Al 

Cc 

CB 


Variables represent numeric values. In the 
statement: 


26 A= 8 + 2 
A is the variable and 8+2 or 16 is the value a 
assigned to A. A new value can be assigned to A at 


a subsequent point in the program. 
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20.1 Fatal Errors 

Stand 

Alone 

BASIC Disk BASIC 
Error Error 

Code Number Message 
SY 1 Syntax 
US 2 


BASIC ERROR MESSAGES 


Using Syntax 
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Meaning 


This error message covers 
a number of errors which 
can occur when the user is 
entering (typing in) a 
program. For example: 
Unmatched parentheses: 
A= (B¥* (C) 
Misspelled words: 
PIRNT A 
Wrong data type: 
Bad punctuation: 
PRINT A(7;2) 
Because there is only one 
message for all these 
errors, a dollar sign is 
printed under the line in 
error at a position 
approximately indicating 
the position of the error. 


AS=3*A 


The format string for a 
PRINT USING instruction is 
in error. For example: 


PRINT USING “#.##!E!0", 
3.2E9 
(only 3 exclamation 


marks; 4 required) 
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#A 


IL 


PS 


iG 


# ( 


6 


8 


Number of 
Arguments 


No Disk in 
System 


Illegal 
Statement 


Print Item Size 


Too Many GOSUBS 


EXP Too Complex 
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A function call requires a 
different number of 
arguments than the number 
passed to it. For 
example: 

DEF FNA(X,Y)=X+Y 

PRINT FNA (J) 


In a stand alone system, a 

request for a disk-only 

function was made. 

e.g., OPEN\1\"LP" 
(presumably the user 
meant "SLP") 


(1) This can be caused by 
entering a line with a 
syntax error and then 
RUNning the program 
without correcting the 
line. 


(2) In certain systems, 
certain statements can be 
declared invalid. For 
example, POKE might be 
illegal in a time-sharing 
system. 


An attempt was made to 
print a single item which 
required more characters 
than the current page 
width. e.g9., 

SET 6,10 

PRINT "LOTS OF 
CHARACTERS" 


Subroutines are nested 
within subroutines to a 
depth which exceeds that 
allowed by BASIC. 


Too many levels of 
expressions, too many 
parentheses or function 
references. 
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RT 


NX 


FU 


DV 


Li 


ets) 


#S 


EL 


18 


12 


LS 


14 


15 


16 


1@1 


Return, No GOSUB 
Active 


NEXT Without FOR 


Function not 
Defined 


DIMension 
Statement Error 


GOTO /GOSUB 
Undefined Line 
Number 


Subscript Values 


Number of 
Subscripts 


End of Statement/ 


End of Line 
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The program has no place 
to return. This can be 
caused by deleting a line 
with a GOSUB statement and 
then encountering its 
RETURN statement. 


FOR and NEXT statements 
must be paired, This 
error may occur if a line 
containing a FOR statement 
is deleted. 


A user function is 
referenced by the program 
but has not been defined. 
If the line containing the 
DEF FNs(X) is deleted, the 
function is no longer 
defined. 


Invalid argument(s) in the 
DIMension statement. For 
example: a negative 
number, DIM A (-2@); too 
many subscripts, DIM B 
(5,5,5,5); too large an 
integer, > 16382. 


A GOTO or GOSUB statement 
refers to a line that does 
not exist. 


The values assumed by 
subscripts must be less 
than those in the 
DIMension statement. 


The number of subscripts 
associated with a variable 
must match the number of 
subscripts in the 
DIMension statement. 


This is an internal BASIC 
error - please document 
and mail to Cromemco, 
Customer Service Dept. 
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SZ 


182 


Array or String There is not enough memory 
Space Overflow to store the array or 
string. 
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20.2 User Trappable (Non-Fatal) Errors 


Stand 

Alone 

BASIC Disk BASIC 

Error Error 

Code Number Message Meaning 


NF 128 File not Fnd File not found on disk 
(file not in directory) or 
the device name is not in 
the device directory list. 


FN 129 Filename A disk file name was used 
in a Stand Alone System or 
an illegal file name was 
passed, 


CM 13@ Invalid Cmd for A command was given to a 
Device device which that device 
was incapable of 
performing. For example: 
( a read command given to a 
. line printer. 


FO 13% File Already Open An OPEN command was given 
to a file which was 
already open. 


NO 132 File Not Open A read or write was 
attempted using a file 
which had not been OPENed. 


FE 133 File Number The file number requested 
was outside the allowable 
range. The file number 
must be greater than @ and 
less than or equal to the 
maximum channel number. 


OP 134 Cannot Open A message from the device 
File driver (or CDOS). (A non- 
zero value returned on 

OPEN.) 
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FS 


NC 


HX 


BO 


135 


136 


137 


138 


139 


146 


141 


20 
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No File Space 


File Mode Error 
File Already 


Exists 


File Read: No 
Data 


File Write 


File Position 


No Channel 
Available 


Invalid Hex 
Number 


Integer Overflow 
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All files in use. The 
system must have one 
unused channel to do a 
LIST, ENTER, SAVE, or 
LOAD, 


CDOS only - no more space 
on disk (or there are 64 
directory entries). 


A READ was attempted from 
a write only file or vice 
versa. 


An attempt was made to 
CREATE a file that already 
exists. 


End of file read, or, for 
random access only, an 
attempt to read a portion 
of the file which had not 
been written. 


A message from CDOS - an 
attempt was made to write 
to a write protected disk 
Or an error occurred while 
writing to the disk. 


An attempt was made to 
read a negative file 
record or record larger 
than 248K bytes. 


All I/O channels in use. 
(The maximum number of 
channels is system 
dependent.) 


Hexadecimal numbers 


must contain only the 
characters § through 9 and 
A through F, 


A value greater than 32767 


was assigned to an integer 
variable. 


raat 
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FA 


IN 


IN 


DM 


ND 


DT 


Et 


LL 


262 


283 


204 


205 


286 


267 


208 


289 


219 


Function Arg 
Value 


Invalid Input 


Input 


Not Dimensioned 


No Data Statement 


Data Type 
Mismatch 


Number Size 


Line Length 


Input Timeout 
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A function was called 
using an illegal argument. 
For example: SOR (-2). 


An attempt was made to 
INPUT non-numeric data 
into a numeric variable. 


An attempt was made to 
INPUT more items that were 
called for in the Input 
instruction, 


A reference was made to a 


subscripted variable which 
had not been dimensioned. 


An attempt was made to 
READ past the end of the 
DATA supplied. Either 
there was a READ with no 
DATA statement or there 
were not as many items in 
the DATA statement as in 
the READ list. 


An attempt was made to 
READ a numeric value to a 
string variable or vice 
versa. For example: 

18 DATA 5 

28 READ AS 


An attempt was made to 
assign a value outside of 
the range 9.99F+62 to 
9.99E-65 to a variable, 


A line longer that 132 
characters was entered. 


See the SET instruction 
for information about this 
error. 
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OV 250 


Overflow/ 


Underflow 


Notes: 


The character * in 
column indicates 
applicable. 
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A floating point operation 
produced a number outside 
of the range 9.99E+62 to 
9.99E-65. For example: 
A=1/8. Or, Integer 
arithmetic caused results 
outside of the range - 
32768 to 32767. 


the Stand Alone BASIC Error Code 
that the error message is not 


ao 


gow 
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DEC. HEX 
OOO OO 
O81 O1 
G02 G2 
083 63 
GG4 04 
G85 65 
O06 06 
007 07 
068 08 
G89 g9 
G19 OA 
G11 0B 
G12 OC 
G13 @D 
G14 OE 
815 OF 
G16 19 
@17 ll 
018 12 
G19 13 
G20 14 
G21 15 
G22 16 
G23 L7 
G24 18 
@25 19 
G26 1A 
G27 1B 
G28 ic 
G29 1D 
G30 1E 
G31 1F 
G32 20 
033 21 
G34 22 
835 23 
G36 24 
837 25 
G38 26 
G39 27 
G49 28 
O41 29 
G42 2A 


US 


(CTRL-@) 
(CTRL-A) 
(CTRL-B) 
(CTRL-C) 
(CTRL-D) 
(CTRL-E) 
(CTRL-F) 
(CTRL-G) 


(CTRL-N) 
(CTRL-O) 
(CTRL~-P) 
(CTRL-Q) 
(CTRL-R) 
(CTRL-S ) 
(CTRL-T) 
(CTRL-U) 


(CTRL-V) 
(CTRL-W) 
(CTRL-X) 
(CTRL-Y) 
(CTRL-Z) 
(CTRL-[) 
(CTRL-\) 
(CTRL~] ) 
(CTRL-*) 
(CTRL-_) 


(SPACE) 


DEC. 


G43 
G44 
G45 
G46 
047 
G48 
G49 


HEX 
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ASCII CHARACTER CODES 


CHAR. 


CHNDWONVOZSBSMAGHMODWRMONQWP BvvVvlarws&§ ODNHAUNBWNHEH AN 


DEC. 


G86 
887 
888 
089 
G98 
G91 
G92 
693 
G94 
G95 
696 
G97 
G98 
G99 
190 
161 
192 
163 
194 
105 
106 
197 


108 
109 
11 
lll 
112 
113 
114 
115 
116 
ay 
118 
119 
128 
121 
122 
123 
124 
125 
126 
127 


LF=Line Feed FF=Form Feed CR=Carriage Return DEL=Rubout 


ESC=ESCAPE 
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CHAR. 


"A wet AON K KX SS 


Ao TO hoeadoew» 


Iw—anNK KX ZESeCrHNAQOTONBDASH 


DEL 
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OVERLAY STRUCTURE 


These programs demonstrate the ability of 
Cromemco's 16K Extended BASIC to overlay or have 
one program overlay (part of) itself with another. 
This feature is very useful for running large 
programs on smaller systems. 


Space is most efficiently used if the same line 
numbers are used in all programs which are to be 
overlayed. In the following example, program ONE 
is run and calls in program TWO. 


PROGRAM "ONE" 


1 GOTO 19 

5 ENTER "TWO" 

1@ DATA 1,2,3,4,5, 
20 READ A,B,C,D,E, 
38 GOTO 5 


PROGRAM "TWO" 


19 X=A+B+C+D 
20 Y=E+F4+G+H+I 
30 Z=X+Y 

4®@ PRINT X,Y,Z 
5@ END 


>>ENTER "ONE" 


>>RUN 
18 35 45 
*k*OQG END*** 


When program ONE is entered and RUN, line 1 passes 
control to line 18. Then at line 298, the DATA from 
line 18 is READ into variables A through I. 
Control is then passed to line 5 which calls in the 
second program. Program TWO overlays lines 10, 29, 
and 38. The line which follows line 5 is line 196. 
Now, however, line 18 is a line from program TWO. 
The rest of program TWO is executed with the 
results being printed out by line 48. 
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AUTOMATIC STARTUP AND 


PROGRAM EXECUTION FROM CDOS 


A very powerful feature of the Cromemco Disk 
Operating System (CDOS) is the ability to enter 
directly into an application program when powering 
up the computer. This is especially useful for the 
inexperienced user as there is no need to deal with 
any of the commands which are used to load and 
execute a program. 


If, for example, the user wants to execute the 
BASIC program ‘'START.SAV' automatically when CDOS 
is entered, the following steps should be followed: 


ans Make sure that there is a copy cf the 
batch command file '@.COM' on DISK A, 


2. Save the BASIC program you want RUN in a 
file (in this example we are using 
"START.SAV'). The program must be SAVEd 
(not LISTed) in order for this to work! 
Our program for this example is: 


198 REM THIS IS MY 
195 REM APPLICATION PROGRAM! 


118 A=5 
128 B=16 
13@ PRINT "THE ANSWER IS: "> A*B 
148 END 
3. Using the editor, create a file named 


"STARTUP.CMD' on a disk A. Note that 
this must be named 'STARTUP.CMD' as this 
is the file name that CDOS looks for. In 
this example, the command file should 
contain the line: 


BASIC START.SAV 
Then, when CDOS is entered, the batch 
command will call BASIC which will RUN 
the saved program 'START.SAV. 
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4. When the computer is turned on and CDOS 
is entered (you have to hit the carriage 
return several times), our example will 
output the following: 

CROMEMCO CDOS VERSION XX.XX 


A.@ STARTUP 
BATCH VERSION XX.XX 


A.BASIC START.SAV 
CDOS 16K BASIC, VERSION X.XX 
THE ANSWER IS: 590 
eE*1AD END*** 
Di If the first program line is a NOESC or 


ONESC, the user can be prevented from 
ever leaving the running BASIC program. 
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MIXED MODE ARITHMETIC 


There are three types of numbers in BASIC, Integer 
Short Floating Point (SHORT), and Long Floating 
Point (LONG), (hexadecimal constants are treated as 
integers). Any arithmetic computation, assignment, 
INPUT, or READ can be performed using any one or 
more of these types of numbers. 


An assignment, READ, or INPUT will automatically 
convert the number to the type of the receiving 
variable. This is the variable which is on the 
left of the equal sign in an assignment 
instruction, and in the data list in the READ and 
INPUT instructions. 


In general, numbers are converted to other types 
freely as needed. For example: 


SIN (38) works, even though the SIN function 
must have a LONG argument. The 
Integer 38 is converted to a Long 
Floating Point number. 


SYS (2.6) works, even though the SYS function 
must have an Integer argument. The 
Long (or Short) Floating Point 
number 2.6 is converted to an 
integer (rounding to 3.8). 


Most problems will occur with mixed mode arithmetic 
involving Integer numbers. Remember that all 
constants without a decimal point and with a value 
less than 18,000 are stored as Integers. 


Examples: 


>>SHORT §S 
>>INTEGER I 

>>8 6 s.e Lo 
>>S A Uy eee a < 


This example will assign a value of @ to S. This 
is because I/3 is evaluated first (rules of 
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precedence, arithmetic operators). Because both I 
and 3 are Integers, I/3 is evaluated as a @ using 
Integer arithmetic. Zero times anything, no matter 
what type, is still @. 


>>SHORT S 
>>INTEGER 
>>S 
>>S 


ou 
fo>) 


I 
I=1 

Df 33 

This example will assign a value of 2 to S. This 
time S*I is evaluated first, and because this is 
mixed mode arithmetic, the shorter form is 
converted to the longer form (I's value is 
converted to SHORT). Then S*I is equivalent to 


6.8*1.8 or 6.8. We are left with 6.8/3, mixed mode 
again. 


The Integer 3 (the shorter type) is converted to 
Short Floating Point (the longer type) and the 
division is performed. S is assigned a value of 
6.0/3.0 or 2.0. 


>>INTEGER S 

>>SHORT S 

>>LONG L 

>>I =1l:S=3: L=l 


If at this point we give the command: 
>>L = L/S 


L will be assigned a value of 6.33333333333333 
because L/S is evaluated as Long Floating Point 
(the longer type). 


If instead we have given the command: 
>>L = I/S 


L would have been assigned the value of 
G.33333300000008 because I/S is evaluated as Short 
Floating Point (the longer type, but still only 6 
digits of accuracy) and then assigned to a Long 
Floating Point variable (L) with 14 digits of 
accuracy. 


Conversion of both types of floating point numbers 
to Integer numbers and vice versa does take time. 
Also Arithmetic, indexing, and subscripting with 
floating point numbers is much more time consuming 
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than it is using Integers, 


Time can be saved by using Integer numbers wherever 
possible, Where it is not possible, care in 
Precedence ordering can result in significant time 
Savings. If L is type LONG and I is type INTEGER, 
the first of the following commands will execute 
faster than the second one, 


>>L 
>>L 


I*IT*I*T *h 
L*¥I*T *T ¥*] 


This is because, until the last multiplication, the 
first example is using Integer arithmetic, The 
second example uses Long Floating Point arithmetic 
from the Start, because the LONG variable is at the 
left and this is where evaluation of this 
expression begins. 
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PATCH SPACE 


Disk Version: The only space available in the disk 
version of 16K BASIC for user patches is at 
hexadecimal locations 425 to 4FF and 183 to I1FF. 


The user can put and SAVE (using CDOS) a patched 
ROUTINE at these locations. 
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CROMEMCO 16K EXTENDED BASIC 


AREAS OF USER INTEREST 


Notes: 


l. XX stands for: @4 if you are using CDOS 
88 if you are using SAB 


2. CDOS is the Cromemco Disk Operating System 
SAB is the BASIC Stand Alone Operating System 


36 Many of these values may be changed by the SET 
instruction. If necessary, and with care, 
they may be changed with the POKE instruction, 
Refer to the Appendix section on Changing the 
number of I/O Channels for an example. 


Hex No. of 


Address Bytes Version 


XXBB 3 CDOS 
SAB 
XXG3 3 Both 


Description 


A jump (JP) to the routine 
where BASIC uses the 
address of the bottom of 
CDOS to establish the top 
of user program space. 


A jump (JP) to the routine 
which uses repeated RETURN 
characters to initialize 
the baud rate. After baud 
rate is established, BASIC 
automatically "sizes" RAM 
memory (Starting at 
location @) to establish 
top of user program space. 


A jump (JP) to a point in 
BASIC equivalent to a 
request to enter a new 
program line. Does not 
destroy program currently 
in memory. 
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XX@6 3 Both 
XXB9 3 Both 
XX@OC 3 CDOS 
SAB 
Both 
XXOF 3 CDOS 
SAB 


A jump (JP) to a point in 
BASIC equivalent to 
issuing a SCRatch command. 
Does not re-size memory. 


A jump (JP) to a point in 
BASIC equivalent to the 
point reached via the jump 
at XX®@@ except that memory 
sizing and baud rate 
initialization do not take 
place. On entry here, HL 
register pair should 


used as top of user 


program space, and the A 


register should contain 
the number of fi Le 


An illegal instruction (FF 
Hex, actually a RST 38H), 
which CDOS traps and uses 
to display an error 
message. 


A jump (JP) to the "IL" 
(Illegal command) error 
message. 


If a CROMEMCO monitor 


resides in PROM at E#@® 


hex, these 3 bytes should 
be changed to a jump (JP) 
to the breakpoint handler 
in the monitor. In case 
of failure in BASIC, the 
breakpoint information 
thus displayed might prove 
extremely valuable. 


A jump (JP) to the CDOs 
warm-Sstart at address 
GOOG. Used by the BYE 
command to return to CDOS. 


A jump (JP) to location 
E@08 Hex, the warmstart 
point in the CROMEMCO 
Monitor. Used by the BYE 
command to exit to the 
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monitor. CAUTION: BYE 
should not be used in 
systems without a monitor. 


XX12 2 Both The address pointer used 
by BASIC to locate the 
beginning of the Device 
Driver LIST. The user may 
use this address to find 
the DDLIST or may change 
it to force BASIC to use 
an alternate DDLIST. 


XX14 2 CDOS The address pointer to the 
beginning of the ERROR 
MESSAGE. The format of 
error messages in memory 
is as follows: 


3 Bytes -- Call to error 
printer 
1 Byte -- Error number 
fo n Bytes -—- ASCII message, 
a terminated by a 
: 8 byte. 


XX14 2 SAB The address pointer to the 
beginning of the ERROR 
MESSAGES. The format of 
error messages in memory 
is as follows: 


3 Bytes -- Call to error 
printer 

2 Bytes -- The error code, 
second byte 
first. 


XX16 1 Both The maximum number of 
channels which can be 
allocated at one time. 
Each I/O channel occupies 
192 bytes of memory. 


XX17 1 Both The number of characters. 
per line. The default 
value is 8@. See SET 
instruction. 


i XX18 1 Both The number of characters 
per TAB position. The 
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XX19 


XX1A 


XX1B 


XX1C 


XX1D 


Both 


Both 


Both 


Both 


Both 


default value is 2@. See 
the SET instruction. 


The character which is 
used as a rubout, default 
value is 5FH (underline). 


Default type of numeric 
variables and constants 
where l=Integer, 2=Short 
Floating Point, and 4=Long 
Floating Point. The 
default value is 4, 


Line delete character. 
The default value is 
control-U. 


The carriage return delay 
(number of nul characters 
sent after a carriage 
return). The default 
value is @. 


Backspace echo —- must 
terminate with a @. The 
default value is back- 
space, space, backspace, 
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DETERMINING THE ADDRESS OF A STRING 


The address of any string may be determined as 
follows: 


19 L=LEN(X$) : A=SYS (2) 
or 
208 A=SYS (2+0*LEN (XS) ) 


When the length of a string is taken, its address 
is automatically placed in SyYS(2). CAUTION: 
SYS(2) is also used to store the most recent I/0 
character (to console or file). So don't mix 
usages of the address capability with I/0 
statements, including TRACE. It is probably best 
to put the two statements on a single line or 
statement, as shown. 


NOTE: In the unlikely event that a program is 
using SYS(2) in its old sense of "last character", 
only the least significant byte of SYS(2) receives 
the character. The most significant byte may be 
reset via SET 2,0, or masked off via BINAND 
(SYS (2) ,255),. 


Another Caution: Adding (or ENTERing) new 
statements or variables can cause string addresses 
to change. Use SYS(2) just before you need the 
address (typically for a USR call). You could even 
do the following: 


A=USR ($430%,LEN (AS) ,SYS (2) ) 
to pass the address and length of a string. 


Also, A=LEN(A$(B)) : S=SYS(2) produces the address 
of the Bth character of the string AS. 
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ADDING DEVICE DRIVERS TO BASIC 


Declaring Device Drivers 


All I/O devices to be accessed from BASIC must be 
declared in the device driver list. This list 
Starts at location DDLIST and each entry is 8 bytes 
long. These entries are of the following form: 


device name (ASCII) 


byte @ first letter second letter byte 
base address of device letter 
2 LSB MSB 
4 information needed by driver 


The device name (bytes 86 and 1) is used for finding 
the correct device to OPEN. For example, 
OPEN\2\"SLP" would instruct BASIC to search the 
device driver list for device name "LP" (the $ 
indicates a device instead of a disk file). The 
driver's starting address occupies the next two 
bytes. Actual addresses and equated value may vary 
depending on both revisions and which version of 
BASIC is being used. The following two bytes are 
reserved for use by the driver and their 
function(s) are defined by the person programming 
the driver. This device driver list can be placed 
in PROM. These two bytes are thus not intended as 
temporary storage areas. 


A typical use of one of these bytes might be to 
hold the actual device address to be accessed. 
This would, for example, allow a general purpose 
TU-ART driver to drive several ports each dedicated 
to a different device. 
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The last two bytes of each table entry are reserved 
for future use. The table itself is terminated by 
the first nul driver name (Hex @8 in the first 
character of the name). 


Rules for Device Drivers 


The actual device drivers must follow certain 
prescribed rules. In particular, the first 16 byte 
locations in the driver must contain address 
pointers to the various routines (some of which are 
required) in a BASIC driver. The 16 bytes define 
the addresses of 8 different routines as shown in 
the following table: 


(LSB) (MSB) 
Byte @ Byte 1 
2 3 
. 4 5 
6 7 
8 9 
16 ll 
12 3 
14 15 


If any of the routines noted above are not defined 
for a given driver, the corresponding address field 
should be set to @@@@H. However, if a routine is 
(or must be, see below) defined but does not do 
anything, the corresponding address must contain 
the address of an XOR A/RET instruction sequence. 


A description of what must be accomplished by the 
various routines follows. Parameters which may (or 
must) be passed between BASIC and the driver 
routines are always passed in registers, or in the 
Extended File Control Block (EFCB). 


Most of the information needed by the driver 
subroutines may be obtained from (or saved in) the 
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Extended File Control Block (EFCB). 


Register usage is covered in the description of 
each command routine below: 


OPEN: 


CLOSE: 


PUTC: 
GETC: 


This routine should perform any 
processing required to initialize the 
device. For example, a line printer 
driver would typically issue a form 
feed on open. 


On Entry: (A') = no. of parameters 
(@,1,or 2) 
(IY) = ADDR of EFCB 
®, 1, or 2 parameters are 
passed to the routine in 
locations EFCBP1 and 
EFCBP2 of the EFCB. 


On Return: A not equal to @ Says 
can't open. This is a 
user-trappable run time 
error. 


This routine should perform processing 
necessary to "shut down" the device. 
For example, a paper tape punch driver 
might punch out a trailer piece of 
tape. 


On Entry: (IY) = ADDR of EFCB 


On Return: A not equal to @ Says 
can't close. This is a 
user-trappable run time 
error. 


These routines perform byte-by-byte 
transfers to and from the device. 
Devices requiring a buffer may use the 
buffer (and/or extended buffer) in the 
EFCB. 


On Entry: (IY) = ADDR of EFCB 
(A) is character to be 
written (PUTC only) 


On Return: (A) used for character 
read (GETC only) 
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SSTAT: 


GSTAT: 


NOTE: 


(SPOS) 


This routine is used to set the status 


of the dev 


ice. For example, a DAZZLER 


driver might use this to set the X/Y 


screen pos 


On Entry: 


On Returns: 


(GPOS ) 


On Entry: 


On Exit: 


Registers IX and 


of these routines. 


The EFCB referred to ha 


EFFCB 
EFCBDA 


EFCBDD 


EFCBP1 


EFCBP2 


EFCBP3 


EFCBP4 


BUFFER 


DS 
DS 


DS 


DS 


DS 


DS 


DS 


DS 


ition. 
(A') = no. of parameters 
(@,l,or 2) 


(IY) = ADDR of EFCB 
®, 1, or 2 parameters are 
passed to the routine in 
locations EFCBP3 and 
EFCBP4 of the EFCB. 


A not equal to @ says 
invalid status request. 
This is a user-trappable 
run time error. 


(IY) = ADDR of EFCB 
(A') = which status is 
requested 


(HL) contains appropriate 
status value. A not equal 
to @ sets a user-trappable 
runtime error. 


TY cannot be changed by any 


s the following format: 


1 ;@=not in use, l=in use 

2 ;Device Driver Address, 
;bytes 2&3 From DDLIST 

2 ;Device Dependent info, 
bytes 4&5 from DDLIST 

2 ;\These are the two optional 


;parameters 


2 7/P1 


& P2 as used in the 


;"OPEN" statement 


2 7\The 


se are the 2 optional 


yparameters Pl & P2 
2 ;/used in PUT, GET, PRINT, 


jand 
179 ;Avai 


INPUT statements 
lable to user for 


gaccumulating individually 
;passed bytes into a buffer 
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When the proper DDLIST entries have been made as 
shown, operation of the driver is as follows: 


OPEN\1,A,B,\"S$DR" 


PRINT\1,X,Y\"HELLO" 


INPUT\1\AS 


A = IOSTAT(1,n) 
where O@<n<255 


CLOSE\1\ 


Calls the OPEN routine of driver 
Lil DR" ra 

EFCBP1 = A, EFCBP2 = B 

A' register = 2, IY= ADDR of EFCB 

If OPEN is not needed, it must 
consist of an XOR A, RET sequence. 


The Set Status routine of "DR" is 
called with EFCBP3 = X, EFCBP4 = Y 
(X and Y are converted to integers 
first). 

A' = 2, IY = ADDR of EFCB 

An XOR A, RET sequence should be 
executed at the completion of Set 
Status. 

Next, the PUTC routine of "DR" is 
called 7 times, once for each 
character to be transmitted plus 
once with a Carriage Return and once 
with a line feed. 

A = character, IY = ADDR of EFCB 


Set Status routine of "DR" is called 
with EFCBP3 = $FFFF%, 

EFCBP4 = $FFFF%, 

A' = @, IY = ADDR of EFCB 

An XOR A, RET sequence should be 
executed. 

Next, the GETC routine of "DR" is 
called repeatedly, expecting one 
byte to be returned in A. This 
continues until a terminator 
(CR,LF,FF,NULL) is transmitted, or 
until more than 132 characters have 
been transmitted. 


The Get Status routine of "DR" is 
called. A* contains n, the 
requested status parameter and IY = 
ADDR of EFCB. The status value to 
be returned should be placed in HL. 
An XOR A, RET sequence should be 
executed last. 


The CLOSE routine of "DR" is called. 
If CLOSE is not needed, an XOR A, 
RET sequence must be provided. 
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Note that if PUT and GET were used in the above 
calls instead of PRINT and INPUT, binary bytes 
would be transmitted according to variable type and 
no carriage control information would be sent. 
I.E., PUT\1\V would transmit two bytes if V is an 
integer, four bytes if v is short floating point, 
and eight bytes if V is long floating point. No 
carriage return or line feed is sent. Also note 
that PRINT\1\"A","B" will not transmit the comma 
but will send. the proper number of spaces to place 
"B" in the next tab field. 
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ADDR 


4B6C 
4B6D 
4BO6E 
4B70® 
4B71 
4B72 
4B73 
4B74 
4B75 
4B76 
4B78 


4B79 
4B7A 


4B7C 
4B7D 
4B7E 
4B86 
4B82 
4B84 
4B85 
4B86 
4B88 
4B8A 
4B8C 
4B8D 
4B8E 
4B98 
4B92 
4B94 


CODE 


me Me NO MO Ne 


DDLIST (DEVICE DRIVER LIST) 


NOTE: THE ADDRESSES SHOWN IN THIS LISTING 
MAY VARY FROM VERSION TO VERSION, but the 
format is identical. The actual starting 
address may be found in locations 9412, 
0413 for CDOS BASIC and 8812, 8013 for 

; Stand Alone BASIC 
DDLIST: 


DDCNSL DB oe a ;'SYSTEM' = CONSOLE 
DW DRTUART 
DB 0,0 
DB 0,® 
DB “TE 5" 72ND TUART PORT 
DW DRTUART 
DB 50H,5@H ;BOTH BYTES GET ADDR 
;OF 2ND TUART 
DW GB ;RESERVED BY SYSTEM 
i 
; CDOS SYSTEM PUNCH READER, AND LIST DRIVERS 
DB PU" 
DW DRCDPU 7;CDOS PUNCH DRIVER 
DW 7) 
DW 0 
DB "RD! 
DW DRCDRD ;CDOS READER 
DW Q 
DW B 
DB 'LP’ 
DW DRCDLP ;CDOS LIST DRIVER 
DW ) 
DW 4) 
DDEND: DB 4) ;END OF DDLIST-NOTE: 


me Me Ne MO 


IF DDLIST IS 
EXTENDED, THIS NULL 
should be overwritten 
and then placed at 
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; end of the new DDLIST 
4B95 DEFS 64 ;RESERVE SPACE FOR 
;MORE DRIVERS 
FFFF IF SOSVER j-------------------- 
DW ! DUMMY 


ELSE j-------------------- 


CDOS PUNCH, READER, AND LIST DRIVER INTERFACES 


ADDR CODE SAMPLE DEVICE DRIVERS 


; 
; PUNCH 
c 
DRCDPU: 
4A9C E64A DW SDUMMY 
4A9E E64A DW SDUMMY 
4AAG E64A DW SDUMMY 
4AA2 E64A DW SDUMMY 
4AA4 AC4A DW SPUPC ;PUNCH OUT CHARACTER 
4AA6 OBOOD DW 4) 
4AA8 BOBO DW i) 
4AAA GLOBO DW i) 
a 
4AAC 5F SPUPC: LD E,A ;GET CHAR TO E REG AS 
;CDOS EXPECTS 
4AAD GEG4 LD Cyd :;CDOS PUNCH ENTRY 
SPULPJ: 
4AAF F5 PUSH AF 
SABO CDB500 CALL CDOS 
4AB3 Fl POP AF 
4ABF c9 RET 
; 
DRCDRD: 
4AB5 E64A DW SDUMMY 
4AB7 E64A DW SDUMMY 
4AB9 E64A DW SDUMMY 
4ABB E64A DW SDUMMY 
4ABD ry) DW 8 
4ABF 054A DW SRDGC ;RDR GET CHAR ROUTINE 
4AC1 GOD DW fe) 
4AC3 OOOH DW ) 
af 
SRDGC: 
4AC5 GEB3 LD Cy3 ;CDOS READER GETC 
;ENTRY PARM 
4AC7 C38588 JP CDOS ;READY TO GO... CHAR 
;RTND IN A 
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DRCDLP: 
4ACA DF4A DW SLPOP ;OPEN ROUTINE 
4ACC E64A DW SDUMMY 
4ACE E64A DW SDUMMY 
4ADO E64A DW SDUMMY 
4AD2 DA4A DW SLPPC ;AND LP PUTC ROUTINE 
4AD4 BOBS DW B 
4AD6 ry) DW B 
4AD8 GOOL DW @ 
SLPPC: 
AADA 54 LD E,A ;MOVE CHAR TO E 
4ADB GEO5 LD C,5 ;CDOS LIST WRITE 
s ENTRY PARM 
4ADD 18D JR SPULPJ 
SLPOP 
4ADF 3E0C LD A, ASCFF ;ISSUE A FORM FEED ON 
sOPENING FILE 
4AE1 CDDA4A CALL S$LPPC 
4AE4 AF XOR A 
4AE5 one) RET ;RET WITH @ STATUS 
SDUMMY: 
4AE6 AF XOR A 
4AE7 C9 RET 
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ACCESSORY I/O DRIVERS 


The DDLIST contains five drivers which may be 
accessed by the user. BASIC treats these drivers 
as files, They must therefore be OPENed and 
CLOSEd, but may not be CREATEd (because they 
already exist). Note that the first three drivers 
are not available in the Stand Alone version of 
BASIC. 


Line Printer Driver 


The system line printer can be accessed by OPENing 
a file named SLP. This driver uses the CDOS system 
call to output data to the line printer. INPUT and 
GET instructions must not be used with this file. 


Punch Driver 


The system punch may be accessed by OPENing a file 
named $PU. This driver uses the CDOS system call 
to output data to the punch. INPUT and GET 
instructions must not be used with this file. 


Reader Driver 


The system reader may be accessed by OPENing a file 
named $RD. This driver uses the CDOS system call 
to input data from the reader. PRINT and PUT 
instructions must not be used with this file. 


Console Driver 


“The System console may be accessed by OPENing a 


file named SsSsyY. This driver bypasses CDOS and 
allows the user to input and output data from/to 
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the console directly by using port @ (UART status) 
and port 1 (UART data). 


TU-ART Driver 


There is a general purpose TU-ART serial I/O port 
driver in the DDLIST called T5. It assumes a TU- 
ART addressed at port 58H and may be used for any 
serial device provided the baud rate is initialized 
prior to its use with an OUT instruction. 


Example: 


16 OUT %58%,4 : REM SET TU-ART TO 399 BAUD 


20 OPEN\2\"ST5" : REM SETS UP DEVICE #2 FOR SERIAL 1/9 


The driver for the system console at port @ is 
labeled "SSY". To switch between the console and a 
second terminal: 

20 OPEN\1\"SSY" 

38 OPEN\2\"ST5" 
This will allow you to later say PRINT\A\"MESSAGE", 


where A can be changed via software to be 1 for the 
console and 2 for another terminal. 
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CHANGING THE NUMBER OF I/O CHANNELS 


BASIC carries 4 I/O channels in addition to the 
console, One I/O channel is needed for each file 
which is OPENed at the same time. Each I/O channel 
occupies 192 bytes of memory. 


If you wish to change the number of channels in 
use, type the following commands while in BASIC: 


Disk System Stand Alone System 

POKE%416%,X POKE%8616%,X 

A=USR (34880%,8) A=USR (%80092%,9) 
where X is the number of I/O channels desired in 
addition to the console. The POKE command puts the 
number of channels desired into the proper location 


and the USR function reinitializes BASIC. 


On a disk system, you can now save this new version 
of BASIC by returning to CDOS and typing: 


>>BYE 


A.SAVE BASIC1.COM 76 
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LOADING 16K BASIC FROM PROM 


I. Memory Requirements: 


1. 16K PROM starting at location 889@6H. 
2. At least 8K RAM starting at location @. 


II. System Set Up: 


A. CROMEMCO 8K BYTESAVER II PROM board: 


Turn PROM program power switch 
'OFF', 


Turn program enable switches 'OFF'., 


Plug the 16 CROMEMCO 16K BASIC PROMS 
into the boards in numerical order. 


board one - 

88098 into PROM socket @ 
8488 into PROM socket 1 
etc, 


board two - 

A®@@@ into PROM socket @ 
A488 into PROM socket 1 
etc. 


Set LOGICAL ADDRESS BLOCK SELECT to 
8800H & AVBBOH 


BYTESAVER II switches: 


board one - 15=1, 14=@, 13=96 
board two - 15=1, 14=@, 13=1 


B. 16KPR board: 


le 


Set LOGICAL ADDRESS BLOCK SELECT to 
8O00H. 


Switch 15=1 
switch 14=9@ 
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2. Plug the 16 CROMEMCO 16K BASIC PROMS 
into the board in numerical order. 


8088 into PROM socket @ 
8488 into PROM socket 1 
etc. 


III. All systems: 


1. Set the jump start address on the ZPU 
board to 8@00@H. 


Switch Al15=1 
A14=8 
Al3=0 
A1l2=@ 


2. Select bank @ on the PROM board (switch 8 
on). r 


IV. Method: 


1. Depress the return key on the console 
several times so that CROMEMCO 16K BASIC 
can determine the baud rate of your 
terminal. 


2. CROMEMCO 16K BASIC will respond with a 
prompt (>>) to indicate that it is ready 
to accept a command. 


3. Refer to the section on Getting Started 


for information on how to proceed from 
this point. 
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